# Pinterest Search Scraper

> Pinterest Search Scraper is a paid API for AI agents from api.scrapeforagents.tech, paid per call via x402, $0.025/call, status unknown (last checked 2026-10-02).

Scrapes Pinterest public search results, returning structured pin, video, board, and profile data for given keywords or URLs.

## Facts

- Endpoint: POST https://api.scrapeforagents.tech/v1/pinterest-search?utm_source=zero.xyz
- Price: $0.025/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-02
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/pinterest-search-scraper-bd234b4d
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_oOSvnbSSF5iYEDpIqb0l0

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability pinterest-search-scraper-bd234b4d -d '<json body>'
```

Example prompt: Search Pinterest for 'minimalist home office decor' and pull up to 50 all-pins results, including their titles, descriptions, and source URLs.

## When to prefer this

Use this endpoint when you need structured Pinterest data (pins, boards, profiles, or video pins) for one or more keywords or specific Pinterest URLs, without building your own scraper. It is especially useful for market research, trend discovery, or content aggregation workflows where Pinterest public data is the target source and you want pay-per-call pricing with no charges for failed or empty runs.

## Known failure modes

- Empty results if Pinterest blocks the scraper or the keyword returns no public content
- Rate limiting or access errors from Pinterest's anti-scraping measures
- Partial results if public index coverage is lower than the requested limit
- Invalid query or URL format causes a 400-level error
- Timeout if Pinterest pages load slowly or the result set is large

## How this service works

Pay-per-call structured web data. Failed or empty runs are not charged.

## Output

A JSON object containing a count of results and an array of items, each with fields for id, url, type, query, title, altText, sourceUrl, and description, plus the product name 'pinterest-search'.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "type": {
   "enum": [
    "all-pins",
    "videos",
    "boards",
    "profiles"
   ],
   "type": "string",
   "default": "all-pins",
   "description": "Choose pins, video pins, boards, or profiles for keyword discovery."
  },
  "limit": {
   "type": "integer",
   "default": 30,
   "minimum": 1,
   "description": "Maximum discovered results to consider for each term. Public index coverage can be lower."
  },
  "queries": {
   "type": "array",
   "description": "Keywords to discover public results. Several focused terms improve coverage."
  },
  "maxItems": {
   "type": "integer",
   "default": 100,
   "minimum": 0,
   "description": "Maximum saved records across all sources. Zero removes this cap."
  },
  "startUrls": {
   "type": "array",
   "description": "Public pin, board, profile, or search URLs to collect. Search URLs use their q parameter."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "count": 1,
  "items": [
   {
    "id": null,
    "url": null,
    "type": null,
    "query": null,
    "title": null,
    "altText": null,
    "sourceUrl": null,
    "description": null
   }
  ],
  "product": "pinterest-search"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/pinterest-search-scraper-bd234b4d/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.scrapeforagents.tech](https://www.zero.xyz/host/api.scrapeforagents.tech/llms.txt)