1080×1620 · 2:3🔥 14.2K Savesgarmentory.com ↗Casa Amarosa Handcrafted Lemon Stoneware Mug
@preview_garmentory_com · Coffee & Tea Cups
$0.08–$0.20 / 1K Pins · 5-Swatch Hex Genome · Boutique Stays · Zero OAuth App Review
Visual Discovery, Aesthetic Color & Boutique Stay Data API.
Query real-time Pinterest pins, dominant hex color palettes, creator moodboards, shop-the-look merchant domains, and Airbnb boutique stays in clean JSON — zero Pinterest OAuth v5 app review waiting. Mint an instant pn_live_ key in 3 seconds with 12,000 free credits ($1.20).
Get Instant API Key — 12,000 Free Credits →$9 Indie Starter Pack (90K Credits)Explore 7 /v1/* Endpoints →
No credit card required · +$2.00 Sandbox Streak bonus · Instant 0%-fee Crypto (+5% bonus)
Click any swatch dot to copy #HEX
Palette DNA:
Try live:
1080×1620 · 2:3🔥 14.2K Savesgarmentory.com ↗
1825×2738 · 2:3🔥 6.8K Saveshoppeshoppe.com · shopify ↗Short Mug in Red-Toned Sandstone Glaze
@hoppeshoppe · Verified Merchant · 12.1K Pins
1024×1536 · 2:3🔥 9.4K Savesetsy.com ↗Sculptural Studio Pottery Espresso Cup
@cbsoules · Hand-Built Pottery Ideas
2250×3000 · 3:4🔥 21.5K Savesetsy.com ↗Wheel-Thrown Speckled Stoneware Mug
@etsy · Verified Merchant · 11.2M Followers
200 OK24 ms2 Credits / pin
Inspecting: Casa Amarosa Handcrafted Lemon Stoneware Mug1080×1620 · 2:3
{
"code": 0,
"provider": "https://pindataapi.com",
"status": "ok",
"msg": "success",
"data": {
"query": "ceramic mug",
"count": 4,
"next_cursor": "Y2JVSG81V2sxcmNHRlpWM1J5VFVad1YxWllhRlJXTVVZMldW...",
"dominant_palette_summary": [
"#C9B096",
"#D4A373",
"#2A9D8F",
"#E76F51"
],
"pins": [
{
"pin_id": "e1_AfqPShwhDXqkIA5FsIxyvJT-zZSIZUd-KpOe2rI_meOHpzVVwnCd",
"title": "LEMON COFFEE MUG",
"dominant_color": "#C9B096",
"palette_hex": [
"#C9B096",
"#FFFFFF",
"#EAEAEB",
"#EAEAEC",
"#3A7FC2"
],
"image_url": "https://i.pinimg.com/originals/69/ba/88/69ba885b9ab40879c14b8979873039c1.jpg",
"width": 1080,
"height": 1620,
"aspect_ratio": "2:3",
"saves_count": 14210,
"is_shoppable": true,
"merchant_domain": "garmentory.com",
"outbound_url": "https://garmentory.com/sale/casa-amarosa/drinkware-coffee-tea/2651956",
"creator": {
"username": "preview_garmentory_com",
"followers": 327,
"verified_merchant": true
}
},
{
"pin_id": "e1_AfqPShz5xeQTD1FJZlTKN6s0JR3fUX4uFFX1KnVLp1Tp_jZHb_B2Dw",
"title": "Short Mug in Sandstone",
"dominant_color": "#C5C4C4",
"palette_hex": [
"#C5C4C4",
"#E5E5E0",
"#CFD4D9",
"#C2CBC9",
"#F4EFE7"
],
"width": 1825,
"height": 2738,
"aspect_ratio": "2:3",
"saves_count": 6840,
"is_shoppable": true,
"merchant_domain": "hoppeshoppe.com"
}
]
},
"meta": {
"request_id": "11d407c7-a85d-499e-b37a-5b8d34ff5841",
"endpoint": "/v1/pins/search",
"credits_charged": 8,
"cached": true,
"took_ms": 24
}
}Zero OAuth App Review · Instant
pn_live_ key in 3sGet 12,000 Free Credits →- Zero OAuth Gatekeeping
- 3 Seconds
- Volume Pin & Board Rate
- $0.08 / 1K pins
- Color Genome Built-In
- 5 Hex Swatches
- Multi-Rail Cache & Failover
- 28 ms warm p50
Instant pn_live_ key vs weeks of v5 OAuth review
2 Credits / pin · 0 Credits charged on empty or 5xx
Dominant #HEX + 5-swatch palette & HD aspect ratio per pin
PostgreSQL 16 + Redis DB 7 + dual Pinterest & Stay rails
Built for Visual Intelligence, E-Commerce & Travel Teams
One studio gateway for aesthetic signals, color palettes & boutique stays
01 · Color-Harmony & Multimodal AI
5-Swatch Hex Palettes & Aspect-Ratio Indexing
Feed multimodal RAG pipelines, interior moodboard generators, and generative design agents with HD pin imagery, exact aspect ratios (2:3, 4:5, 9:16), and pre-extracted 5-color hex genomes.
GET /v1/pins/searchRead blueprint →02 · Shop-the-Look E-Commerce Radar
Viral Merchant Domain & Save Velocity Tracking
Spot breakout Shopify, Etsy, and Garmentory SKUs before ad libraries catch on by tracking real-time Pinterest save/repin velocity and resolved outbound product URLs.
GET /v1/pins/detailsRead blueprint →03 · Creator & Aesthetic Curation
Public Boards, Moodboards & Creator Reach
Discover niche tastemakers, interior stylists, and brand accounts across millions of curated boards with pin counts, follower velocity, and verified merchant websites.
GET /v1/boards/search · /v1/users/profileRead blueprint →04 · Travel & Hospitality Aesthetics
Boutique Short-Term Stays & Superhost Pricing
Pair visual destination moodboards with live Airbnb-grade boutique stay photography, nightly USD pricing, cleaning fees, Superhost ratings, and GPS coordinates.
GET /v1/stays/search · /v1/stays/marketRead blueprint →OpenAPI 3.1 Surface · 7 Normalized /v1/* Routes
Deterministic JSON schemas with automatic multi-rail failover
Masonry Search2 Credits / pin · 0 if empty
GET /v1/pins/searchPinterest Pins, Swatches & Save Velocity
Search public pins by aesthetic keyword with cursor pagination, HD image dimensions, dominant hex + 5-swatch palette, save counts, pinner info, and outbound merchant links.
Pin Genome5 Credits / call
GET /v1/pins/detailsSingle Pin Deep Metadata & Shop Link
Inspect a canonical Pin ID for full-resolution media assets, color swatches, board context, creator attribution, and direct merchant product destination.
Curated Boards2 Credits / board · 0 if empty
GET /v1/boards/searchCreator Boards & Moodboard Collections
Query aesthetic collections ('mid century interior', 'minimalist packaging') returning cover thumbnails, pin totals, curator handles, and board URLs.
Creator Graph10 Credits / profile
GET /v1/users/profileCreator & Brand Profile Telemetry
Fetch public Pinterest creator or merchant profiles by @username including follower counts, monthly view reach, board counts, and verified domain.
Live Check-In5 Credits / stay · 0 if empty
GET /v1/stays/searchBoutique Stays Live Dates & Nightly Rates
Search short-term rental listings by city, check-in/out dates, and guest count with gallery photos, nightly & total USD pricing, Superhost badges, and lat/lng.
Market & Geo3 Credits / stay · 2 Credits / lookup
GET /v1/stays/market · /v1/stays/destinationsCity Supply Benchmarks & Destination IDs
Index market-wide short-term stay supply, bedroom mix, and review scores across global travel markets, plus sub-second destination autocomplete.
Unified Credit Rate Card ($1.00 = 10,000 Credits · Zero Charge on Empty or Error)
| Visual / Hospitality Capability | Endpoint | Batch Size | Credit Cost | Effective Rate |
|---|---|---|---|---|
| Pinterest Pins Masonry Search (HD Images, 5-Swatch Hex Palette, Aspect Ratio, Saves, Merchant Domain) | GET /v1/pins/search | Up to 50 pins / call | 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} | 1 full pin object / call | 5 Credits / pin lookup | $0.20 – $0.50 / 1,000 pins |
| Creator Moodboards & Aesthetic Collections Search | GET /v1/boards/search | Up to 50 boards / call | 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} | 1 creator profile + recent pins / call | 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 | Up to 40 stays / call | 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 | Up to 50 market listings / call | 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 | 5–15 destinations / call | 2 Credits / request | $0.08 – $0.20 / 1,000 calls |
OAuth 2.1 · PKCE S256 · Read-Only Scope (mcp:tools:read)$1.20 (12,000 Free Credits) Auto-Granted
Claude Web / ChatGPT 1-Click Visual Discovery MCP URL
Paste into Claude.ai (Settings → Integrations → Add Custom Connector) or ChatGPT Connectors to let AI agents search Pinterest pins, dominant hex swatches, creator boards, and boutique stays with 1-click sign-in:
https://mcp.pindataapi.com/v1/mcpUsing Cursor, Claude Desktop, Claude Code CLI, or custom SDKs with an x-api-key header? Connect to https://api.pindataapi.com/mcp or see the full MCP setup guide →
Creator-Friendly Hybrid Billing
Start free with 12,000 credits, grab the $9 Indie Pack, or scale to $0.08/1K
Pay with Credit/Debit Card, Apple Pay, Google Pay (official VAT/EIN PDF invoices), or 0%-fee Multi-Chain Cryptocurrency (+5% bonus credits).
$9.00 Indie Starter Micro-Pack
Buy $9 Indie Pack →90,000 never-expiring Credits (~45,000 Pins or 18,000 Boutique Stays · 94,500 w/ +5% Crypto bonus) + 60 RPM unlocked. Zero monthly commitment.
Unified Ledger: $1 = 10,000 Credits · 2 Credits = 1 Pin · 5 Credits = 1 Stay (0 Credits on empty search)
Free Studio
$0free sandbox
12,000 Credits
$1.20 Instant + $2.00 Streak Bonus · 30 RPM
Instant API key in 3 seconds — zero Pinterest OAuth app review wait. Includes 12,000 free credits ($1.20) + up to $2.00 Sandbox Streak bonus.
Included
- ✓$1.20 Free Credits (12,000 Credits) instantly — no credit card required
- ✓Zero Pinterest OAuth approval queue — live pn_live_ key in 3s
- ✓5-swatch dominant hex palette & shop-the-look links included
- ✓30 RPM (2 RPS) sandbox concurrency
- ✓0 Credits charged on 0-result searches & failed calls
Starter
$19/ month
Or $9 PAYG (90,000 never-expiring Credits)
250,000 Credits
+31% Bonus · $0.15 / 1K Pins · 120 RPM
Built for moodboard tools, Shopify/Etsy trend scouts, design studios, and indie AI agents.
Included
- ✓250,000 Credits / month (+31% bonus credits)
- ✓$0.15 per 1,000 Pinterest pins or boards
- ✓120 RPM (5 RPS) production concurrency
- ✓All 7 REST endpoints + OAuth 2.1 Remote MCP
- ✓Unused credits roll over while active; PAYG never expires
Pro Studio
Most Popular$69/ month
Or $89 PAYG (1,200,000 never-expiring Credits)
1,200,000 Credits
+74% Bonus · $0.115 / 1K Pins · 300 RPM
For visual e-commerce discovery engines, color forecasting platforms, and travel price intelligence.
Included
- ✓1,200,000 Credits / month (+74% bonus credits)
- ✓$0.115 per 1,000 Pinterest pins or boards
- ✓300 RPM (10 RPS) high-speed concurrency
- ✓Real-time upstream refresh (?fresh=1) + Webhooks unlocked
- ✓VAT/EIN billing details & 0%-fee Crypto (+5% bonus)
Business Scale
$199/ month
Or $249 PAYG (5,000,000 never-expiring Credits)
5,000,000 Credits
+151% Bonus · $0.08 / 1K Pins · 600 RPM
High-throughput visual graph & hospitality dataset feed for multimodal AI training, ad-creative analytics, and OTA aggregators.
Included
- ✓5,000,000 Credits / month (+151% bonus credits)
- ✓$0.08 per 1,000 Pinterest pins (lowest visual data rate)
- ✓600 RPM (15 RPS) priority gateway routing
- ✓Unlimited webhooks & real-time upstream refresh
- ✓99.95% Uptime SLA & priority engineering support
Need 1,000+ RPM? Dedicated Enterprise Key Pool available — isolated multi-rail visual & hospitality capacity, custom burst RPS, and SLA-backed volume pricing.
Contact Studio Infrastructure →Interactive Visual Workload & Proxy-Savings Estimator
- PinData API (Studio Subscription Rate)
- $15.20
- Cloud Browser Actors + Residential Proxies ($2.50/1K)
- $250.00
- Your Monthly Savings
- $234.80
$0.15 / 1,000 pins · Base PAYG: $20.00
$2.50 per 1,000 pins
Up to 96% lower cost · 0 Credits on 0 results
Engineering & Migration Guides
Pinterest, Color Trend & Boutique Stay Blueprints
Pricing & Architecture Breakdown · 2026 Edition
Pinterest API Pricing in 2026: Official OAuth v5 Limits vs Real-Time Visual Data Costs
Understand what the Official Pinterest API v5 covers for free (authenticated user/ad management), why global public search is gated behind OAuth scopes, and how to budget $0.08–$0.20 per 1,000 public pins with PinData API.
Engineering Blueprint · Python & TypeScript
Pinterest Scraper API Guide (2026): Extract Pins, Boards, Creators & Merchant Links Cleanly
Stop maintaining fragile headless browsers and __PWS_INITIAL_PROPS__ hydration regexes. Query normalized Pinterest Pins, Boards, and Creator Profiles over synchronous REST or Remote MCP.
Travel & Hospitality Intelligence · 2026 Guide
Airbnb API Alternative for Developers (2026): Boutique Stays, Nightly Rates & Market Benchmarks
Airbnb's official Partner API is closed to independent developers and travel startups. Query live short-term stay pricing, Superhost badges, coordinates, interior galleries, and city-wide market supply with one API key.
AI Agents, E-Commerce & Color Intelligence
Building a Visual Trend, Color-Palette & Shop-the-Look Engine with PinData API
Turn live aesthetic signals — dominant hex swatches, save velocity, creator board taxonomies, and outbound merchant domains — into structured product intelligence.
Head-to-Head Provider Benchmarks
PinData API vs Official API v5, Cloud Actors & Proxies
vs Official Pinterest API v5
Compare pricing, OAuth friction & latency →Instant Public Visual Search vs Weeks of OAuth v5 App Review.
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.
vs Apify Scrapers
Compare pricing, OAuth friction & latency →Real-Time REST & MCP JSON vs 25-Second Container Cold Starts.
Containerized scraper Actors are built for offline cron jobs: every lookup boots a headless browser container, burns residential proxy bandwidth, and forces your backend to poll /acts/.../runs until a dataset is ready. PinData API serves normalized Pins, Boards, Profiles, and Boutique Stays over synchronous HTTP GET and Remote MCP in 35 ms (warm cache) to 1.6 s (live fetch) — with $0 monthly platform fees.
vs Enterprise Web Unlockers
Compare pricing, OAuth friction & latency →$9 Indie Starter vs $500/mo Enterprise Proxy Minimums.
Raw residential proxy networks and Web Unlockers charge $1.50–$3.50 per 1,000 unblocked requests (often with $500/month minimum commitments) and still dump 600 KB of obfuscated hydration scripts in your lap. PinData API delivers clean, typed JSON with extracted hex palettes, aspect ratios, merchant domains, and nightly stay pricing starting from a $9 never-expiring starter pack.
vs AirDNA
Compare pricing, OAuth friction & latency →Self-Serve Stays & Pricing JSON vs Custom Enterprise Contracts.
AirDNA excels at multi-year macro short-term rental reports, but its programmatic REST API is gated behind enterprise sales consultations — while its self-serve $125/mo ($400/yr) Market Research plan does not include API keys. PinData API issues a live pn_live_ key in 3 seconds with 12,000 free credits ($1.20) to query live check-in/check-out stay pricing, Superhost ratings, calendar availability windows, and listing-level details from $0.20/1K requests.
Technical, Schema & Billing FAQ
Frequently Asked Questions
How does the $1 = 10,000 Credits pricing model work?
PinData API uses a transparent item-based credit ledger where $1.00 = 10,000 Credits. Pinterest Pin and Board search endpoints (/v1/pins/search and /v1/boards/search) cost 2 Credits per returned record ($0.20 per 1,000 base, down to $0.08 per 1,000 on the Business plan). Single Pin inspection (/v1/pins/details) and Boutique Stay search (/v1/stays/search) cost 5 Credits per record ($0.50 per 1,000 base). Rental market benchmarks (/v1/stays/market) cost 3 Credits per listing, creator profiles (/v1/users/profile) cost 10 Credits, and destination autocomplete (/v1/stays/destinations) costs 2 Credits per request. Empty results or failed calls always cost 0 Credits.
Do I need an approved Pinterest Developer OAuth v5 app or user access tokens?
No. Official Pinterest API v5 requires manual developer app review, business verification, and user-scoped OAuth tokens that cannot search global public aesthetic trends, shop-the-look outbound links, or multi-swatch dominant color palettes. PinData API issues a live pn_live_ key in 3 seconds with zero OAuth approval waiting.
How are the Dominant Hex Color Swatches and aspect ratios extracted?
Every pin, creator board, profile, and boutique stay returned by PinData API includes normalized image dimensions (width, height, aspect_ratio such as '2:3' or '4:5'), a primary dominant_color hex code, and a 4-to-5 swatch palette_hex array ready for CSS variables, moodboard generators, shop-the-look visual search, and AI design agents.
What travel and short-term stay data do /v1/stays/* endpoints include?
Our /v1/stays/search, /v1/stays/market, and /v1/stays/destinations endpoints return normalized boutique stay listings with nightly USD pricing, total stay price, guest rating, review volume, Superhost & Rare Find badges, bedroom/bed/bath counts, GPS coordinates, and high-resolution interior photo galleries — backed by multi-rail automatic failover.
What is the response latency for cached vs. live real-time queries?
Queries hitting our warm PostgreSQL 16 + Redis DB 7 visual index respond in 18–45 ms. Cold long-tail queries or paid requests passing ?fresh=1 execute a live multi-rail fetch in 1.1–2.2 seconds and automatically write-through to our persistent index.
Am I charged when a search returns 0 results or when an API request fails?
Never. Searches that return 0 matching pins, boards, or stays cost 0 Credits. Missing Pin IDs (HTTP 404), invalid parameters (HTTP 400), rate-limited requests (HTTP 429), and gateway errors (HTTP 5xx) always cost 0 Credits.
Should I start with the $9 Indie Starter Pack, a Monthly Subscription, or larger PAYG packs?
For side projects, prototypes, and AI agents, the $9 Indie Starter Micro-Pack grants 90,000 never-expiring Credits (+5% Crypto bonus = 94,500 Credits, ~45,000 pins) and unlocks 60 RPM. For continuous production pipelines, Monthly Subscriptions ($19 Starter / 250K credits at 120 RPM, $69 Pro / 1.2M credits at 300 RPM, $199 Business / 5M credits at 600 RPM) lower your unit cost down to $0.08 per 1,000 pins. Larger one-time PAYG packs ($25 / $89 / $249) never expire.
What are the RPM rate limits across Free Trial and Paid plans?
Free Trial accounts include 12,000 instant Credits ($1.20 + up to $2.00 Sandbox Streak bonus) and 30 RPM (2 RPS). Paid accounts unlock burst-smoothed concurrency: 60 RPM / 3 RPS ($9 Indie Starter), 120 RPM / 5 RPS (Starter), 300 RPM / 10 RPS (Pro), and 600 RPM / 15 RPS (Business). Need 1,000+ RPM? Dedicated Enterprise Key Pool available.
What payment methods and invoice options are supported?
Every new account starts with 12,000 Free Credits ($1.20) + up to $2.00 in Sandbox Streak rewards. For top-ups ($9+ PAYG) and monthly subscriptions, we support instant 0%-fee Multi-Chain Cryptocurrency checkout (USDT, USDC, BTC, SOL, ETH, BNB across Solana, Tron, Polygon, Arbitrum, BSC, and Ethereum) with an automatic +5% Bonus Credits reward and corporate VAT/Tax ID billing profiles.
What is your refund policy?
Payments made within the last 14 days are eligible for a pro-rated refund of unused purchased credits. Promotional signup credits have no cash value.