PinterestPinterest BoardsPinterest TopicsAPI Guide

Pinterest Boards API: List Boards, Collect Board Pins and Size Topics

Three new SocQ Pinterest endpoints: a profile's boards with counts, the pins saved to a board, and a topic's monthly searches with narrower topics. Requests, fields and per-result prices.

SocQUpdated November 19, 20266 min read

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 urls to POST /v1/pinterest/user-boards, /board or /topic with Authorization: Bearer $SOCQ_API_KEY. Poll GET /v1/tasks/{task_id} until status is succeeded, then read data.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

EndpointWhat it returnsInputPrice
User BoardsA profile's public boards with name, description, cover, owner, creation date, and pin, follower, section and collaborator countsProfile URLs0.5 credits ($0.0025) per board
Board PinsThe pins on a board, in board order, with description, saver, full-size image and pin linkBoard URLs0.5 credits ($0.0025) per pin
TopicA topic's monthly search count and the narrower topics Pinterest suggestsIdea page URLs0.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:

  1. User Boards on a competitor's profile to see which boards have the most followers and pins.
  2. Board Pins on the boards that matter to collect the images and descriptions inside them.
  3. 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