# Pinterest Scraper API (x402)

> Pinterest Scraper API (x402) is a paid API for AI agents from x402.186-241-26-229.sslip.io, paid per call via x402, $0.025/call, status unknown (last checked 2026-10-01).

Scrapes structured public Pinterest data — pins, boards, profiles, and search results — returning enriched metadata per pin on a pay-per-call basis.

## Facts

- Endpoint: POST https://x402.186-241-26-229.sslip.io/v1/pinterest?utm_source=zero.xyz
- Price: $0.025/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-01
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/pinterest-scraper-api-x402-d2c3972a
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_yGfrrE_k-GnN1q1HysqwU

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-scraper-api-x402-d2c3972a -d '<json body>'
```

Example prompt: Pull up to 50 pins from the Pinterest board at https://www.pinterest.com/pinterest/holiday-decor-ideas/ and give me each pin's title, image URL, description, and source domain.

## When to prefer this

Choose this endpoint when you need structured Pinterest pin data — titles, image URLs, descriptions, source domains — extracted from public boards, profiles, or search results, without building your own scraper. Especially useful for trend research, content aggregation, and visual asset collection. Pay-per-call pricing with no charge on empty runs makes it cost-efficient for exploratory queries.

## Known failure modes

- Private or deleted board/profile returns empty items array with no charge
- Search query returns no indexed results — empty items array, no charge
- Invalid or malformed Pinterest URL causes request failure
- maxPins or maxItems cap reached before all sources are exhausted
- Rate limiting or blocking by Pinterest's public web layer returns empty result
- Network or scraper infrastructure timeout

## How this service works

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

## Output

A JSON object with a count field and an items array, where each item contains the pin's id, url, title, domain, altText, imageUrl, description, and thumbnailUrl. Failed or empty runs are not charged.

## 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-scraper-api-x402-d2c3972a/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.186-241-26-229.sslip.io](https://www.zero.xyz/host/x402.186-241-26-229.sslip.io/llms.txt)