1. Official Pinterest API v5 Access Tiers vs. Public Trend Intelligence
Before estimating API costs, separate publishing/ad-management workflows from public visual discovery workflows.
Pinterest's official v5 REST API divides applications into Trial Access (sandboxed / limited daily calls) and Standard Access (requires business verification, privacy policy review, and a recorded OAuth screencast walkthrough). Even after Standard approval, endpoints operate within user-granted OAuth scopes rather than open global search.
If you are building an e-commerce trend radar, shop-the-look visual search engine, interior design moodboard generator, or AI creative agent, you need public pins, dominant hex color palettes, save velocity, and merchant domains across millions of creators — with zero user OAuth prompts.
| Provider / Approach | Onboarding Time | Effective Cost / 1K Pins | Warm / Live Latency | Dominant 5-Swatch Hex |
|---|---|---|---|---|
| PinData API (pindataapi.com) | 3 seconds (instant pn_live_) | $0.08 – $0.20 / 1,000 pins | 35 ms warm · 1.4 s live | Included on every pin |
| Official Pinterest API v5 | Days–weeks (OAuth review) | $0 (own/consented OAuth scope only) | 200–400 ms | Limited / own pins only |
| Cloud Browser Actors (Apify) | Instant (async batch) | $1.20 – $3.50 / 1K + $39/mo base | 18 – 45 s cold start | Varies by community script |
| Enterprise Web Unlocker Proxies | Sales / KYB or $500/mo min | $1.50 – $3.00 / 1K raw HTML | 3 – 9 s + DIY parser | None (parse yourself) |
2. PinData API Credit Rate Card ($1.00 = 10,000 Credits)
Credits deduct strictly on HTTP 200 non-empty responses. Empty searches, 404s, and upstream retries cost 0 Credits.
| Endpoint | Credits Billed | PAYG Base Rate | Pro ($69/mo) | Business ($199/mo) |
|---|---|---|---|---|
| GET /v1/pins/search | 2 Credits / pin | $0.20 / 1K pins | $0.115 / 1K pins | $0.08 / 1K pins |
| GET /v1/pins/details | 5 Credits / pin | $0.50 / 1K pins | $0.29 / 1K pins | $0.20 / 1K pins |
| GET /v1/boards/search | 2 Credits / board | $0.20 / 1K boards | $0.115 / 1K boards | $0.08 / 1K boards |
| GET /v1/users/profile | 10 Credits / profile | $1.00 / 1K profiles | $0.58 / 1K profiles | $0.40 / 1K profiles |
| GET /v1/stays/search | 5 Credits / stay | $0.50 / 1K stays | $0.29 / 1K stays | $0.20 / 1K stays |
| GET /v1/stays/market | 3 Credits / listing | $0.30 / 1K listings | $0.17 / 1K listings | $0.12 / 1K listings |
| GET /v1/stays/destinations | 2 Credits / call | $0.20 / 1K calls | $0.115 / 1K calls | $0.08 / 1K calls |
Inspect Live Credit Headers in Every Response
Every response includes x-credits-cost and x-credits-remaining HTTP headers alongside meta.credits_charged in the JSON body.
curl -i "https://api.pindataapi.com/v1/pins/search?query=ceramic+mug&limit=4" \
-H "x-api-key: pn_live_your_api_key"import requests
res = requests.get(
"https://api.pindataapi.com/v1/pins/search",
params={"query": "ceramic mug", "limit": 4},
headers={"x-api-key": "pn_live_your_api_key"},
timeout=20,
)
print("Credits used:", res.headers.get("x-credits-cost"))
print("Palette:", res.json()["data"]["dominant_palette_summary"])const res = await fetch("https://api.pindataapi.com/v1/pins/search?query=ceramic+mug&limit=4", {
headers: { "x-api-key": process.env.PINDATA_API_KEY },
});
const json = await res.json();
console.log(json.meta.credits_charged, json.data.dominant_palette_summary);{
"code": 0,
"provider": "https://pindataapi.com",
"status": "ok",
"data": {
"query": "ceramic mug",
"count": 4,
"dominant_palette_summary": ["#C9B096", "#D0CDC1", "#C5C4C4", "#B2B2B0"],
"pins": [
{
"pin_id": "e1_AfqPShwhDXqkIA5FsIxyvJT-zZSIZUd-KpOe2rI_meOHpzVVwnCd",
"title": "LEMON COFFEE MUG",
"dominant_color": "#C9B096",
"palette_hex": ["#C9B096", "#FFFFFF", "#EAEAEB", "#EAEAEC", "#3A7FC2"],
"aspect_ratio": "2:3",
"merchant_domain": "garmentory.com"
}
]
},
"meta": {
"endpoint": "/v1/pins/search",
"credits_charged": 8,
"cached": true,
"took_ms": 18
}
}Interactive Studio Workbench · GET /v1/pins/search
Verify real-time latency, credit math & JSON schema
Frequently Asked Questions
- Is there a low-cost starter option without a monthly subscription?
- Yes. Beyond the 12,000 free trial credits on signup, the $9.00 Indie Starter Pack grants 90,000 never-expiring Credits (+5% Crypto bonus = 94,500 Credits, or ~47,250 pins) and unlocks 60 RPM.
- Can I estimate my exact monthly spend before integrating?
- Yes — open our interactive /tools/pinterest-api-pricing-calculator to model any combination of Pin searches, Creator Profiles, and Boutique Stay queries across PAYG and Monthly plans.