# Pinterest Search Scraper (x402)

> Pinterest Search Scraper (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-02).

Scrapes Pinterest public content—pins, videos, boards, and profiles—by keyword queries or direct URLs, returning structured metadata per item.

## Facts

- Endpoint: POST https://x402.186-241-26-229.sslip.io/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-x402-f7279f1c
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_L8VHnCQd9SMbDjQW9T59b

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-x402-f7279f1c -d '<json body>'
```

Example prompt: Search Pinterest for 'minimalist home office decor' and collect 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 content data—pins, boards, videos, or profiles—by keyword or URL without managing your own scraping infrastructure. Prefer it over generic web scrapers because it returns Pinterest-specific fields (alt text, pin type, source URL) in a normalized schema. The pay-per-call model with no charge for failed or empty runs makes it low-risk for exploratory queries.

## Known failure modes

- Empty result set if Pinterest's public index has no coverage for the given queries (not charged)
- Invalid enum value for 'type' field returns validation error
- Request with no queries and no startUrls returns empty or error
- Rate limiting or IP blocking by Pinterest may reduce coverage
- maxItems cap of 0 may return unexpectedly large datasets if not managed

## 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 returned items and an array of structured records, each with fields: id, url, type (pin/video/board/profile), query term used, title, altText, sourceUrl, and description. Only non-empty successful runs are charged.

## 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-x402-f7279f1c/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)