# Pinterest Scraper

> Pinterest Scraper is a paid API for AI agents from agent-data.centorprat.workers.dev, paid per call via x402, $0.04/call, status unknown (last checked 2026-10-29).

Scrapes Pinterest pins from keyword searches, profiles, and boards, returning titles, descriptions, images, links, reactions, pinner info, and keyword analytics without requiring login.

## Facts

- Endpoint: POST https://agent-data.centorprat.workers.dev/tools/pinterest-scraper?utm_source=zero.xyz
- Price: $0.04/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-29
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/pinterest-scraper-b2dab65b
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_jj5uIhDDZGq8wd1QqqjSl

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

Example prompt: Can you scrape Pinterest for up to 30 pins about 'bohemian living room decor', only include pins that link to a website, and give me a keyword summary showing the top domains and pinners?

## When to prefer this

Use this endpoint when you need structured Pinterest data — pins, profiles, or boards — without authentication, and want keyword-level analytics (top domains, pinners, promoted share) alongside individual pin metadata. It is the right choice for market research, influencer profiling, e-commerce competitive intelligence, and content trend analysis on Pinterest. Prefer it over generic web scrapers when you specifically need Pinterest's pin structure, pinner attribution, and reaction data in a single call.

## Known failure modes

- Profile or board URL not found — returns empty results, not charged
- Search query returns zero pins matching filters — empty array returned
- maxPins value exceeds schema maximum of 50 — rejected with validation error
- Pinterest blocks or rate-limits the scrape — may return partial results
- Invalid URL format for boards or profiles — parse or lookup error

## How this service works

Pay-per-call data and tools for AI agents, $0.002-0.01 per call in USDC via x402 (Base, Polygon or Solana), no account or API key; MAX tiers ($0.05-0.25) run deeper jobs. Agent toolkit: web search, search + read top pages, any page as clean markdown with a prompt-injection check, which-x402-API-to-call recommender, seller check. Data: Google Maps places with contacts, YouTube video data and transcripts, job listings (Indeed, LinkedIn, 13 boards), Google Ads Transparency, TikTok comments, Pinterest, Airbnb, Redfin, AliExpress, app stores, live sports, website and SEO checks, Shopify store tech stacks, and onchain token / address risk checks.

## Output

Returns an array of pin objects each containing title, description, outbound link, domain, image URL, reaction counts, pinner username, board name, and flags for promoted/product pins. Profile lookups also return follower count, monthly views, and website. Search queries optionally include a free keyword summary row with top linked domains, top pinners, and promoted/product/video share percentages.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "boards": {
   "type": "array",
   "items": {
    "type": "string"
   },
   "maxItems": 1,
   "description": "Board URLs, e.g. [\"https://www.pinterest.com/TileBar/tiles-backsplashes/\"]."
  },
  "maxPins": {
   "type": "integer",
   "maximum": 50,
   "description": "Up to this many pins per keyword, per profile and per board."
  },
  "profiles": {
   "type": "array",
   "items": {
    "type": "string"
   },
   "maxItems": 1,
   "description": "Usernames or profile URLs, e.g. [\"tilebar\", \"https://www.pinterest.com/marthastewart/\"]. Returns profile stats (followers, monthly views, website) and their pins."
  },
  "profilePins": {
   "type": "boolean",
   "description": "Also scrape each profile's created pins (off = profile stats only)."
  },
  "onlyWithLink": {
   "type": "boolean",
   "description": "Drop pins that don't link to a website (search results only)."
  },
  "searchQueries": {
   "type": "array",
   "items": {
    "type": "string"
   },
   "maxItems": 1,
   "description": "Pinterest searches, e.g. [\"kitchen ideas\", \"summer dress\"]. Each gives its pins plus a free keyword summary (top domains, top pinners, promoted share)."
  },
  "keywordSummary": {
   "type": "boolean",
   "description": "Add one free summary row per search: top linked domains and pinners, promoted / product / video share."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "items": [
   {
    "url": "https://www.pinterest.com/pin/e1_AfqPShw03e3zdGNqxTRsaexIV4GtE_XBFwIMCksBLDaOZV9uT2_5/",
    "link": "https://www.tilebar.com/montauk-gin-2x8-ceramic-wall-tile-satin.html",
    "type": "pin",
    "pinId": "e1_AfqPShw03e3zdGNqxTRsaexIV4GtE_XBFwIMCksBLDaOZV9uT2_5",
    "saves": null,
    "title": "Explore Montauk Gin 2x8 White Ceramic Subway Wall Tile with Mixed Finish",
    "domain": "tilebar.com",
    "altText": "a kitchen with wooden cabinets and white counter tops",
    "isVideo": false,
    "imageUrl": "https://i.pinimg.com/originals/bc/54/e8/bc54e89cd5e3e093314c3349401ec38e.png",
    "createdAt": "2024-01-14T07:22:59+00:00",
    "reactions": 59,
    "description": "The Montauk Gin 2x8 White Ceramic Wall Tile reimagines the subway format in durable ceramic—with a distinctively modern feel. The pure white coloring complements a wide range of palettes and design styles. Surface shading and a variety of matte and satin finishes offer artisanal touches to all applications. Get yours now.",
    "dominantColor": "#846c4c"
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/pinterest-scraper-b2dab65b/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agent-data.centorprat.workers.dev](https://www.zero.xyz/host/agent-data.centorprat.workers.dev/llms.txt)
