# PinData API (https://pindataapi.com)

> Real-time REST & Remote MCP API for Pinterest visual pins, 5-swatch dominant hex color palettes, creator moodboards, merchant shop-the-look links, and Airbnb boutique stay listings & market pricing — with zero Pinterest OAuth app review waiting.
> Base API Gateway: https://api.pindataapi.com
> 1-Click Claude Web & ChatGPT Remote MCP (OAuth 2.1 PKCE + Bearer Key): https://mcp.pindataapi.com/mcp (alias: https://mcp.pindataapi.com/v1/mcp)
> API-Key Streamable HTTP MCP Endpoint: https://api.pindataapi.com/mcp
> AI Agent Skill Manifest: https://pindataapi.com/SKILL.md (and https://pindataapi.com/.well-known/skills/default/SKILL.md)
> APIs.json Discovery Manifest: https://pindataapi.com/apis.json
> Full Machine-Readable Reference for LLMs: https://pindataapi.com/llms-full.txt
> OpenAPI 3.1 Spec: https://pindataapi.com/openapi.json (and https://api.pindataapi.com/openapi.json)

## Pricing & Unit-Based Credit System ($1 = 10,000 Credits)

- Unit Rule: **$1.00 = 10,000 Credits**
- Pinterest Pins Search (`/v1/pins/search`): **2 Credits / pin returned** ($0.08–$0.20 per 1,000 pins; min 4 Credits; 0 Credits if empty)
- Single Pin Full Inspector (`/v1/pins/details`): **5 Credits / lookup** ($0.20–$0.50 per 1,000 lookups)
- Creator Moodboards Search (`/v1/boards/search`): **2 Credits / board returned** ($0.08–$0.20 per 1,000 boards; 0 Credits if empty)
- Creator & Merchant Profile (`/v1/users/profile`): **10 Credits / profile** ($0.40–$1.00 per 1,000 profiles)
- Airbnb Boutique Stays Search (`/v1/stays/search`): **5 Credits / stay returned** ($0.20–$0.50 per 1,000 stays; 0 Credits if empty)
- Short-Term Rental Market Benchmark (`/v1/stays/market`): **3 Credits / listing returned** ($0.12–$0.30 per 1,000 listings)
- Travel Destination Autocomplete (`/v1/stays/destinations`): **2 Credits / call**
- Free Studio Trial: **$1.20 (12,000 Credits) free instantly** on sign-up (no credit card, zero Pinterest OAuth wait, 30 RPM / 2 RPS) + **+$2.00 (+20,000 Credits)** Developer Sandbox Streak bonus ($3.20 / 32,000 total free credits = 16,000 pins)
- Indie Starter Micro-Pack (Never Expires): **$9 one-time** -> 90,000 Credits (94,500 Credits w/ Crypto +5% bonus, 60 RPM)
- Starter Plan: **$19/mo** -> 250,000 Credits/mo (+31% bonus, $0.15 / 1K pins, 120 RPM / 5 RPS)
- Pro Studio Plan: **$69/mo** -> 1,200,000 Credits/mo (+74% bonus, $0.115 / 1K pins, 300 RPM / 10 RPS)
- Business Scale Plan: **$199/mo** -> 5,000,000 Credits/mo (+151% bonus, $0.08 / 1K pins, 600 RPM / 15 RPS)
- Additional Never-Expiring PAYG Packs: $25 (250k Credits), $89 (1.2M Credits), $249 (5M Credits)
- Refunds: payments from the last 14 days, up to the unused balance

## Latency SLA & Multi-Rail Failover

- **Warm PostgreSQL 16 + Redis DB 7 Cache**: `18–45 ms`
- **Live Multi-Rail Pinterest & Airbnb Upstream Fetch**: `0.6–1.8 s`
- **Zero Pinterest OAuth App Review**: Generate a live `pn_live_` API key in 3 seconds at `https://pindataapi.com/signup`.

## AI Agent, Free Studio Tools & Core Pages

- Official Claude / Cursor AI Skill Manifest: [SKILL.md](https://pindataapi.com/SKILL.md)
- Complete Single-File LLM Reference: [llms-full.txt](https://pindataapi.com/llms-full.txt)
- OpenAPI 3.1 JSON Specification: [openapi.json](https://pindataapi.com/openapi.json)
- Apify Pinterest & Airbnb Actor Migration Bridge: [Migrate from Apify](https://pindataapi.com/from-apify)
- Free Visual Color Palette & Hex Swatch Extractor: [Color Palette Extractor](https://pindataapi.com/tools/pinterest-color-palette-extractor)
- Free Pinterest Pin ID, Aspect Ratio & Shop-Link Inspector: [Pin ID Extractor](https://pindataapi.com/tools/pinterest-pin-id-extractor)
- Free Pinterest & Airbnb API Cost Calculator: [Pricing Calculator](https://pindataapi.com/tools/pinterest-api-pricing-calculator)
- Live 7-Day API Status & p50/p95 Latency Monitor: [API Status](https://pindataapi.com/status)
- Visual Studio Tools Hub: [Tools Hub](https://pindataapi.com/tools)
- Remote Streamable HTTP MCP Server (`https://api.pindataapi.com/mcp`): [MCP Guide](https://pindataapi.com/mcp)
- Creator & Studio Affiliate Program (20% Recurring): [Affiliate Program](https://pindataapi.com/affiliate)

## Engineering Guides (/guides)

- [All Engineering Guides](https://pindataapi.com/guides)
- [Pinterest API Pricing in 2026: Official OAuth v5 Limits vs Real-Time Visual Data Costs](https://pindataapi.com/guides/pinterest-api-pricing): Complete 2026 breakdown of Pinterest API pricing, Trial vs Standard OAuth v5 access tiers, rate limits, and unit economics for public pin, board, and color palette discovery.
- [Pinterest Scraper API Guide (2026): Extract Pins, Boards, Creators & Merchant Links Cleanly](https://pindataapi.com/guides/pinterest-scraper-api-guide): Step-by-step developer guide to extracting Pinterest pins, cursor pagination, creator boards, verified merchant links, and 5-swatch hex color palettes in Python & Node.js.
- [Airbnb API Alternative for Developers (2026): Boutique Stays, Nightly Rates & Market Benchmarks](https://pindataapi.com/guides/airbnb-api-alternative): Official Airbnb Partner API is closed to public signups. Learn how developers query live boutique stays, nightly USD pricing, Superhost ratings, and market supply via PinData API.
- [Building a Visual Trend, Color-Palette & Shop-the-Look Engine with PinData API](https://pindataapi.com/guides/visual-trend-discovery-api): Architect an automated visual trend radar, dominant hex color palette clustering pipeline, and AI moodboard agent using PinData API and Remote MCP.

## Competitor Comparisons (/compare)

- [All Provider Comparisons](https://pindataapi.com/compare)
- [PinData API vs Official Pinterest API v5](https://pindataapi.com/compare/pinterest-official-api-v5-alternative): Compare PinData API against Official Pinterest API v5: skip weeks of Trial/Standard OAuth review, query public pins, boards, dominant hex palettes, and merchant links instantly.
- [PinData API vs Apify Scrapers](https://pindataapi.com/compare/apify-pinterest-airbnb-scraper-alternative): Replace async Apify Actor cold starts, residential proxy surcharges, and $39/mo platform fees with PinData API's synchronous REST & MCP gateway from $9 PAYG.
- [PinData API vs Enterprise Web Unlockers](https://pindataapi.com/compare/bright-data-pinterest-scraper-alternative): Skip $500/mo enterprise proxy minimums and HTML hydration parsing. Query clean structured JSON for Pinterest Pins, Color Palettes, and Boutique Stays from $9.
- [PinData API vs AirDNA](https://pindataapi.com/compare/airdna-alternative): Self-serve AirDNA API alternative: skip enterprise sales contracts and query live short-term stay pricing, ratings & availability from $0.20/1K ($9 PAYG).

## Endpoints

### Pinterest Visual Pins & Palette

- [Search Pinterest pins with 5-swatch hex palettes & shop-the-look domains](https://pindataapi.com/docs/pins-search): `GET /v1/pins/search` (2 Credits / Pin)
- [Inspect single Pinterest pin metadata, color swatches & outbound product URL](https://pindataapi.com/docs/pins-details): `GET /v1/pins/details` (2 Credits / Pin)

### Creator Boards & Profiles

- [Search curated Pinterest moodboards & aesthetic collections](https://pindataapi.com/docs/boards-search): `GET /v1/boards/search` (2 Credits / Pin)
- [Inspect Pinterest creator or verified merchant profile](https://pindataapi.com/docs/users-profile): `GET /v1/users/profile` (2 Credits / Pin)

### Airbnb Boutique Stays & Markets

- [Search boutique short-term stays with nightly USD rates, Superhost badges & HD photos](https://pindataapi.com/docs/stays-search): `GET /v1/stays/search` (2 Credits / Pin)
- [Fetch short-term rental market supply, average nightly ADR & Superhost share](https://pindataapi.com/docs/stays-market): `GET /v1/stays/market` (2 Credits / Pin)
- [Autocomplete travel destinations, cities & neighborhoods](https://pindataapi.com/docs/stays-destinations): `GET /v1/stays/destinations` (2 Credits / Pin)

## FAQ

### 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.