SocQ's first Pinterest endpoints read profiles, single pins, a user's pins and search results. On 2026-11-17 three more went live, and they work at a different level: boards and topics. Boards show how a brand or creator organizes ideas; topics show how many people search for an idea and which narrower ideas sit under it.
This guide explains what each new endpoint returns, the request, the price and how the three fit together. If you are comparing Pinterest data providers in general, see 7 Best Pinterest Scraper APIs.
Quick answer: Send Pinterest profile, board or idea-page URLs in
urlstoPOST /v1/pinterest/user-boards,/boardor/topicwithAuthorization: Bearer $SOCQ_API_KEY. PollGET /v1/tasks/{task_id}untilstatusissucceeded, then readdata.results.items. All three cost 0.5 credits per result ($0.0025 at $0.005 per credit), with no base fee.
The Three New Pinterest Endpoints
| Endpoint | What it returns | Input | Price |
|---|---|---|---|
| User Boards | A profile's public boards with name, description, cover, owner, creation date, and pin, follower, section and collaborator counts | Profile URLs | 0.5 credits ($0.0025) per board |
| Board Pins | The pins on a board, in board order, with description, saver, full-size image and pin link | Board URLs | 0.5 credits ($0.0025) per pin |
| Topic | A topic's monthly search count and the narrower topics Pinterest suggests | Idea page URLs | 0.5 credits ($0.0025) per topic |
Pinterest User Boards: Audit a Profile
The Pinterest User Boards API lists every public board on a Pinterest profile. Each board comes with its name, description, cover image, owner, creation date and counts for pins, followers, sections and collaborators, plus an is_collaborative flag for boards other accounts can add pins to. It is the first call when you audit a competitor's Pinterest or shortlist creators by topic: the counts show which themes an account invests in and which collections people actually follow.
curl -X POST "https://api.socq.ai/v1/pinterest/user-boards" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"urls": ["https://www.pinterest.com/marthastewart/"],
"results_limit": 25
}'
Use profile URLs such as https://www.pinterest.com/username/. results_limit applies to each profile, defaults to 25 and accepts 1 to 500. Board counts sit under metrics: pins_count, followers_count, sections_count and collaborators_count. See the User Boards docs.
Pinterest Board Pins: Collect What a Board Holds
The Pinterest Board Pins API returns the pins inside a board, in the order the board shows them. Each pin includes its title or description, the account that saved it, the full-size image (with a thumbnail and dimensions under media) and its pin URL. Point it at a curated board in your niche to collect reference images, track what a competitor keeps adding to a seasonal board, or build a mood-board dataset in one pass.
curl -X POST "https://api.socq.ai/v1/pinterest/board" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"urls": ["https://www.pinterest.com/lizmrodgers/moms-night/"],
"results_limit": 50
}'
Use board URLs in the form /{username}/{board}/. results_limit applies to each board, defaults to 50 and accepts 1 to 1,000. See the Board Pins docs.
Pinterest Topic: Keyword Research for Pinterest
The Pinterest Topic API sizes up a topic before you build content for it. For each idea page you get the monthly search count Pinterest reports (search_count) and the narrower topics it suggests underneath (related_topics, each with a name, a short label and its own idea-page URL), such as the styles, occasions and materials people combine with the main idea.
curl -X POST "https://api.socq.ai/v1/pinterest/topic" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"urls": ["https://www.pinterest.com/ideas/home-decor/935249274030/"]
}'
Use idea page URLs in the form /ideas/{topic}/{id}/. Each topic returns one row. Because every narrower topic comes with its own URL, you can feed those URLs back into the same endpoint to compare demand across long-tail angles. See the Topic docs.
How the Three Endpoints Fit Together
A typical competitor or niche study chains them:
- User Boards on a competitor's profile to see which boards have the most followers and pins.
- Board Pins on the boards that matter to collect the images and descriptions inside them.
- Topic on the idea pages for those themes to check monthly search demand and find narrower angles.
For single pins, a user's own pins or keyword search results, use the earlier Pins, User Pins and Search endpoints. All Pinterest endpoints are listed on the Pinterest platform page.
Authentication and the Async Task Flow
Every request carries your API key and a JSON content type:
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
Each submit call starts a background task:
submit -> task_id -> queued -> running -> succeeded
\-> failed
The submit response returns data.task_id and data.status. Poll the task with the same key:
curl "https://api.socq.ai/v1/tasks/$TASK_ID?limit=50" \
-H "Authorization: Bearer $SOCQ_API_KEY"
While the task is queued, running or failed, the response holds task metadata only; on failed, read error_message. When it is succeeded, the same response includes the first page of normalized records in data.results.items. limit defaults to 50 and goes up to 500. If has_more is true, pass results.next_cursor as cursor to read the next page. fields accepts up to 50 comma-separated fields or dot paths when you only need a few columns, for example name,metrics.followers_count for boards.
A client-side timeout does not cancel a task, so resume with the same task_id instead of submitting and paying for a duplicate. To skip polling, add callback_url to the submit body; SocQ sends one POST with a task summary when the task finishes, and you read the records from the task endpoint.
What a Typical Job Costs
- List 25 boards on one profile: 25 × 0.5 = 12.5 credits, $0.0625.
- Collect 1,000 pins from one board: 500 credits, $2.50.
- Check 20 topics: 10 credits, $0.05.
Because results_limit applies per profile or per board, a request with several URLs can return up to that many rows for each one. Set the limit with the number of URLs in mind.
FAQ
Does User Boards return private or secret boards?
No. It lists the public boards on a profile.
What does the Topic search count mean?
search_count is the monthly search count Pinterest reports for the idea page. updated_at is the time Pinterest last refreshed the topic.
Can I get the pins of several boards in one request?
Yes. Put several board URLs in urls. results_limit applies to each board separately, and every pin returned costs 0.5 credits.
Do I pay if a board is empty?
There is no base fee, so you pay only for the boards, pins or topics returned.
Where are the Pinterest prices listed?
Each landing page shows its rate, and the pricing page lists the current credit rate of every SocQ API.
PINTEREST API
Test the workflow with a public Pinterest URL
Submit public inputs and receive normalized records with traceable source context.
Explore Pinterest APIs