PinData API vs Official Pinterest API v5 · Apify · Bright Data ·
3 sec vs 2–4 wks to production API key (zero OAuth app review waiting).
Official Pinterest API v5 is designed for managing an authenticated user's own boards and ad campaigns — requiring business verification, screencast submissions, and user OAuth 2.0 tokens while restricting global public keyword search. PinData API issues a live pn_live_ key in 3 seconds to search public pins, boards, creator profiles, extracted 5-swatch dominant hex color palettes, and shop-the-look merchant links from $0.08–$0.20 per 1,000 pins.
Instant pn_live_ key in 3s · Zero OAuth app review (+20,000 Sandbox Streak Credits) · Top up anytime via 0%-fee Multi-Chain Crypto (+5% bonus credits)
Cost per 1,000 Pinterest Pins (with HD Image, 5-Swatch Hex Palette & Merchant URL)
$1.00 = 10,000 Credits (2 Credits / pin · 5 Credits / boutique stay). Empty search results cost 0 Credits. Crypto top-ups automatically include +5% Bonus Credits.
Side-by-side capability matrix.
| Capability | PinData API | developers.pinterest.com | Apify Actors | Enterprise Unlocker |
|---|---|---|---|---|
| Developer onboarding & approval time | 3 seconds (instant pn_live_ key) | Days to weeks (Trial -> Standard review + video) | Instant, but requires Actor run polling | Sales call or $500/mo commitment |
| Global public keyword pin & board search | Yes (/v1/pins/search & /v1/boards/search) | Restricted to authenticated user's own pins/ads | Yes (20–45s batch cold start) | Raw HTML only (build your own parser) |
| Extracted 5-swatch Dominant Hex Palette | Included on every pin, board, profile & stay | Single color or unavailable on public pins | Inconsistent across community scrapers | None (raw DOM) |
| Shop-the-Look outbound merchant domain | Normalized merchant_domain & outbound_url | Only on your own claimed domain pins | Partial | Manual parsing required |
| Boutique Stay & Travel Market endpoints | Built-in (/v1/stays/search, market, destinations) | Not supported | Separate paid Actor subscription | Separate scraper target |
| Minimum starter spend | $0 Free Trial (12,000 Credits) · $9 Indie Pack | Free only for approved OAuth ad/user apps | $39/mo platform + compute units | $500/mo minimum commitment |
Competitor pricing and access scopes verified from public developer documentation as of November 2026. All third-party trademarks are the property of their respective owners. PinData API rates: $0.08 / 1K pins (Business), $0.115 / 1K pins (Pro), $0.20 / 1K pins (Base PAYG).
PinData API transparent per-endpoint rate card ($1 = 10,000 Credits).
| Capability | Endpoint | Credit Rate | Effective USD / 1K |
|---|---|---|---|
| Pinterest Pins Masonry Search (HD Images, 5-Swatch Hex Palette, Aspect Ratio, Saves, Merchant Domain) | GET /v1/pins/search | 2 Credits / pin returned (min 4 Credits; 0 if empty) | $0.08 – $0.20 / 1,000 pins |
| Single Pin Full Inspector (Image Tiers, Dominant Swatches, Board Context, Outbound Product URL) | GET /v1/pins/details, GET /v1/pins/{pin_id} | 5 Credits / pin lookup | $0.20 – $0.50 / 1,000 pins |
| Creator Moodboards & Aesthetic Collections Search | GET /v1/boards/search | 2 Credits / board returned (min 4 Credits; 0 if empty) | $0.08 – $0.20 / 1,000 boards |
| Creator & Verified Merchant Profile Inspector | GET /v1/users/profile, GET /v1/users/{username} | 10 Credits / profile | $0.40 – $1.00 / 1,000 profiles |
| Airbnb Boutique Stays Search (Nightly USD Rate, Superhost, Rating, Coordinates, HD Photos) | GET /v1/stays/search | 5 Credits / stay returned (min 10 Credits; 0 if empty) | $0.20 – $0.50 / 1,000 stays |
| Short-Term Rental Market Benchmark & Supply Feed | GET /v1/stays/market | 3 Credits / listing returned (min 6 Credits; 0 if empty) | $0.12 – $0.30 / 1,000 listings |
| Travel Destination & Neighborhood Autocomplete | GET /v1/stays/destinations | 2 Credits / request | $0.08 – $0.20 / 1,000 calls |
Why visual AI & commerce teams switch from Official Pinterest API v5.
Zero OAuth 2.0 Token Refresh or Screencast Reviews
Authenticate every server-side or edge request with a single x-api-key: pn_live_... header. Never ask end users to connect their personal Pinterest accounts just to power visual search or moodboard discovery.
Multi-Swatch Hex Color & Aspect-Ratio Metadata Out of the Box
Every pin response ships width, height, aspect_ratio ('2:3', '4:5'), dominant_color, and a 5-swatch palette_hex array so your Masonry UI renders zero layout shift (CLS = 0) with instant color filtering.
Drop-In /v5/* Compatibility Aliases
Already wrote code targeting /v5/pins/search, /v5/boards, or /v5/user_account? Point your base URL at https://api.pindataapi.com and our gateway normalizes the route automatically.
Replace OAuth v5 Boilerplate with 1 Header
Switch from user-scoped OAuth bearer refresh loops to stateless PinData API calls in under two minutes.
// Requires approved app_id, client_secret, redirect_uri & user OAuth consent
const res = await fetch("https://api.pinterest.com/v5/search/pins?query=ceramic+mug", {
headers: { Authorization: `Bearer ${userOAuthAccessToken}` },
});
// Fails for global public trend search outside the authenticated account// Instant pn_live_ key — global public pins, 5-swatch hex palette & merchant links
const res = await fetch("https://api.pindataapi.com/v1/pins/search?query=ceramic+mug&limit=12", {
headers: { "x-api-key": process.env.PINDATA_API_KEY },
});
const { data } = await res.json();
console.log(data.dominant_palette_summary, data.pins[0].merchant_domain);1-Click Remote MCP Connector · Claude Web & ChatGPT
Connect live Pinterest & boutique stay tools via OAuth 2.1.
Paste https://mcp.pindataapi.com/v1/mcp into Claude.ai Settings → Connectors or ChatGPT Developer Mode for 1-click PKCE S256 login (or use https://api.pindataapi.com/mcp with x-api-key in Cursor, Windsurf, and n8n).
Core Endpoints & Studio Guides
- GET /v1/stays/search → Boutique Short-Term Stays & Pricing Docs
- GET /v1/stays/market → Short-Term Rental Market ADR & Comps Docs
- GET /v1/pins/search → Pins Masonry & 5-Swatch Hex Palette Docs
- Airbnb API Alternative (2026) → Stays Search & Rates Guide
- Pinterest API Pricing (2026) → v5 OAuth vs $0.08/1K Breakdown
- Free Tool → Pinterest & Stays API Cost Calculator
- Remote MCP Setup Guide → Claude, ChatGPT & Cursor
Interactive Studio Workbench · Benchmark vs Official Pinterest API v5
Verify real-time latency, credit math & JSON schema
Frequently asked questions
- When should I still use the Official Pinterest API v5?
- Use Official Pinterest API v5 if your SaaS publishes pins onto a customer's own Pinterest account, manages Pinterest Ads Manager campaigns, or reads private analytics for an authenticated brand's owned boards.
- When is PinData API the better fit?
- Use PinData API whenever you need public visual trend discovery, e-commerce shop-the-look product intelligence, moodboard/aesthetic AI agents, dominant hex color extraction, creator profile benchmarking, or boutique travel stay discovery without OAuth gates.
- How quickly can I test PinData API?
- Create a free account at /signup in 3 seconds to receive 12,000 Free Credits ($1.20) immediately — enough for 6,000 pins — plus up to +20,000 bonus Credits via the Developer Sandbox Streak.
Test it against Official Pinterest API v5 for free.
Every new account receives 12,000 free Credits ($1.20) immediately — no card required.