Pinterest Public Data API
Retrieve public Pinterest profile data, resolve known Pins, collect Pins from selected profiles, or search by keyword for creator, content, and visual trend research.
Available Pinterest APIs
Use Profiles for account data, Pins for a known Pin, User Pins for content from selected profiles, or Search for keyword-based Pin discovery.
What Pinterest data can you retrieve?
SocQ returns normalized public account and Pin records with identity, content, media, classification, discovery, engagement, and collection-time context.
Public profile details
Retrieve profile IDs, usernames, display names, bios, images, linked websites, country context, and visible account counts.
Pin content and media
Retrieve Pin identity, title, text, creator details, media references, publication time, and visible metrics when available.
Creator Pin collections
Browse a bounded set of public Pins from selected profile URLs and keep each result connected to its submitted profile.
Topics and classification
Search Pins by keyword and retain available post type, categories, hashtags, source details, and discovery input.
SocQ vs Pinterest API
SocQ focuses on supported public Pinterest collection. Pinterest's official API is designed for authenticated content, advertising, analytics and catalog integrations.
| Capability | SocQ | Pinterest API |
|---|---|---|
| Primary use | Collect public profiles, Pins, user Pins and search results | Manage authorized content, ads, analytics and catalogs |
| Customer OAuth | SocQ API key; no customer Pinterest OAuth | Pinterest app, access token and required scopes |
| Starting input | Public profile or Pin URL, or a text query | Authorized account context and Pinterest resource IDs |
| Create or manage Pins | Not supported | Supported on behalf of an authenticated user with write scopes |
| Response format | Normalized SocQ records | Native Pinterest API objects |
How the Pinterest API works
All four Pinterest APIs use the same asynchronous task and paginated result workflow.
1. Submit your input
Send profile URLs, Pin URLs, or a search query to the matching API and save the returned task_id.
2. Track the task
Poll /v1/tasks/{task_id} until processing is complete.
3. Retrieve the results
Read data.results.items and use next_cursor while has_more is true.
Authenticate with your SocQ API key and submit a text query. Profiles, Pins, and User Pins use the same task flow.
curl -X POST "https://api.socq.ai/v1/pinterest/search" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query":"home office ideas","results_limit":100}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is trueCommon Pinterest API use cases
Creator and profile research
Enrich known profile URLs with public identity, bio, website, country context, visible counts, and collection time.
Known Pin analysis
Resolve selected Pin URLs into content, creator, media, taxonomy, timestamps, visible metrics, and source links.
Creator content monitoring
Collect bounded Pin sets from selected profiles and compare collection-time content and account snapshots.
Visual topic and trend research
Search defined keywords to build structured Pin datasets with creator, media, classification, and discovery context.
Limits and public-data policy
Pinterest results are point-in-time public records. These APIs do not access private content or create, edit, save, or manage profiles and Pins.
- Profiles requires a profile URL with one username path segment. It returns account details, not boards, Pins, or audience-member lists.
- Pins requires a known public /pin/{id} URL or pin.it link and does not expand a profile into a Pin collection.
- User Pins requires public profile URLs. results_limit defaults to 100, accepts 1 to 2,000, and applies separately to each profile.
- Search requires one text query. results_limit defaults to 100 and accepts 1 to 2,000; sort and additional filters are not exposed.
- Optional identity, content, media, classification, source, timestamp, and metric fields can be null or empty when the public source does not expose them.
- The APIs are read-only and do not create, edit, save, or manage Pinterest profiles, boards, or Pins.
Pinterest API frequently asked questions
What is the Pinterest API?
The Pinterest API is a set of SocQ endpoints for retrieving public profile data, resolving known Pins, collecting Pins from selected profiles, and searching public Pins by keyword.
Which Pinterest API should I use?
Use Profiles for account details, Pins for known /pin/{id} or pin.it links, User Pins for a bounded collection from profile URLs, and Search for keyword-based discovery.
Do Profiles and User Pins return the same data?
No. Profiles returns account metadata and aggregate counts, while User Pins returns normalized Pin records discovered from submitted profile URLs.
How does the User Pins result limit work?
results_limit defaults to 100, accepts integers from 1 through 2,000, and applies separately to each profile URL.
Why can fields be null or empty?
A public profile or Pin may not expose every identity, content, media, taxonomy, source, timestamp, or metric value at collection time.
How is Pinterest collection priced?
Each returned profile or Search Pin costs 0.6 credits, while each returned Pin from Pins or User Pins costs 0.5 credits. Empty result sets have no result charge.