# Pinterest Public Data Scraper

> Pinterest Public Data 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 structured pin, board, and profile data from public Pinterest pages via search queries, board URLs, profile URLs, or individual pin URLs

## Facts

- Endpoint: POST https://api.scrapeforagents.tech/v1/pinterest?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-public-data-scraper-a20c0b4d
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_YTDHZ-pl21Wr5WSB0yGjp

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-public-data-scraper-a20c0b4d -d '<json body>'
```

Example prompt: Pull up to 50 Pinterest pins about 'boho living room decor' from the search index and also grab all pins from https://www.pinterest.com/pinterest/holiday-decor-ideas/ — I need the title, image URL, and description for each one.

## When to prefer this

Use this endpoint when you need structured Pinterest pin data — including images, titles, and descriptions — from public boards, profiles, or search results, without managing browser sessions or Pinterest API credentials. Prefer it for pay-per-successful-call economics where failed or empty runs cost nothing.

## Known failure modes

- Empty result set if board or profile is private or removed — not charged
- Rate-limited or blocked scrape returning zero items — not charged
- Invalid URL format causing a 400-level error
- Search query returns no indexed results due to limited public index coverage
- maxPins or maxItems cap reached before all pins are collected, truncating results

## 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 collected items and an array of pin objects, each with fields for id, url, title, domain, altText, imageUrl, description, and thumbnailUrl. The product field confirms 'pinterest'. Failed or empty runs are not billed.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "maxPins": {
   "type": "integer",
   "default": 25,
   "maximum": 1000,
   "minimum": 1,
   "description": "Maximum pins to collect from each query, board, or profile. Public boards expose up to about 25 pins per page."
  },
  "pinUrls": {
   "type": "array",
   "description": "Individual public pin URLs to enrich."
  },
  "maxItems": {
   "type": "integer",
   "default": 0,
   "minimum": 0,
   "description": "Hard cap across all sources. Set 0 for no total cap."
  },
  "boardUrls": {
   "type": "array",
   "description": "Public board URLs such as https://www.pinterest.com/pinterest/holiday-decor-ideas/."
  },
  "profileUrls": {
   "type": "array",
   "description": "Public profile URLs such as https://www.pinterest.com/pinterest/."
  },
  "searchQueries": {
   "type": "array",
   "description": "Discover public pins matching each search phrase through a public web index. Coverage depends on indexed results."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "count": 1,
  "items": [
   {
    "id": null,
    "url": null,
    "title": null,
    "domain": null,
    "altText": null,
    "imageUrl": null,
    "description": null,
    "thumbnailUrl": null
   }
  ],
  "product": "pinterest"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/pinterest-public-data-scraper-a20c0b4d/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)