1. What's the rate limit?
MCP limits apply per PinClicks user account:
Trial and Pin Pro: 10 requests per minute and 100 requests per day
Pin Plus: 25 requests per minute and 250 requests per day
Higher limits are available on request.
2. Do different OAuth clients on the same account get separate limits?
No. Limits are tied to your PinClicks account, not to the app you connect with. If you connect several AI apps or clients (ChatGPT, Claude, Grok, etc.) to one account, they all share that account's allowance.
3. Does using the web app (e.g. loading Top Pins pages) count against the MCP limit?
No. Only requests made through the MCP connector count. Using app.pinclicks.com normally doesn't count toward your MCP allowance.
4. Is there a burst limit?
There's no separate burst limit. The per-minute limit works as the burst cap (10 per minute on Trial and Pin Pro, 25 per minute on Pin Plus), and the daily limit sits on top of it.
5. Is there a documented limits page, and can the limit be raised?
There isn't a public limits page yet, so this Q&A is the reference for now. To get higher limits, upgrade to Pin Plus, or contact support to ask about a custom limit.
6. Could search-top-pins return (label, interest_id) pairs for visual annotations?
Right now search-top-pins returns visual annotations as label text only, without the Pinterest interest IDs. It's a good idea, and we've logged it as a feature request, but it isn't on the roadmap yet.
7. What's the maximum number of IDs per hydrate-interests-by-id call?
Up to 10,000 interest IDs per call. Duplicate IDs are removed, results come back in the same order you sent them, and any IDs we can't find are listed in missing_ids.
Note: these are our current default limits, and they may change.