Documentation
PinData API Reference & Quickstart
7 verified REST endpoints for querying real-time Pinterest pins, 5-swatch dominant hex palettes, creator moodboards, brand profiles, and Airbnb boutique stays — with zero OAuth app review. Generated directly from our OpenAPI 3.1 specification.
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 →
3-Second Quickstart
- 01
Create your studio account & get 12,000 free Credits
Sign up with Google or email. Your first API key (
pn_live_...) is minted automatically in 3 seconds. - 02
Send your first GET request
Pass your key in the
x-api-keyrequest header orAuthorization: Bearer pn_live_....curl "https://api.pindataapi.com/v1/pins/search?query=ceramic+mug&limit=10" \ -H "x-api-key: pn_live_your_api_key"import requests res = requests.get( "https://api.pindataapi.com/v1/pins/search?query=ceramic+mug&limit=10", headers={"x-api-key": "pn_live_your_api_key"}, timeout=30, ) print(res.json())const res = await fetch("https://api.pindataapi.com/v1/pins/search?query=ceramic+mug&limit=10", { headers: { "x-api-key": "pn_live_your_api_key" }, }); const data = await res.json(); console.log(data);
Essentials & Credit Billing
PinData API (https://api.pindataapi.com) delivers normalized JSON for Pinterest visual search, single-pin shop-the-look metadata, 5-swatch dominant hex color palettes, creator moodboards, verified merchant profiles, and short-term boutique stay pricing & availability — with zero OAuth approval queue. Instant pn_live_ API key on signup with 12,000 free credits ($1.20) + up to $2.00 Sandbox Streak bonus.