Pinterest API · Endpoint
Pinterest User API
Get a public profile from its link: username, display name, followers and whether it is a verified partner.
- 1 credit per call
- Failed calls are free
- Updated
- pinterest.user.get
{ "user": { "full_name": "National Park Service", "follower_count": 27614, "username": "natlparkservice", "domain_verified": true, "id": "470204154753594089", "is_partner": true }}
What you send
The input
object of the request, with every field the endpoint accepts.
| Field | Type | Required | What it does | Example |
|---|---|---|---|---|
| url | string | yes | The profile's link, such as https://www.pinterest.com/natlparkservice/. Saved and Created tab links give the same profile. | https://www.pinterest.com/natlparkservice/ |
Fields it returns
What each record in the response holds, with the values from the sample above.
| Field | Type | What it is | Example |
|---|---|---|---|
| user | object | The account. | 6 fields |
| user.full_name | string | The account's display name. | National Park Service |
| user.username | string | The account's username. | natlparkservice |
| user.follower_count | integer | Followers, as Pinterest shows them. | 27,614 |
| user.is_partner | boolean | Whether it is a Pinterest partner account. | true |
| user.domain_verified | boolean | Whether the account's website is verified. | true |
| user.id | string | Pinterest's ID for the account. | 470204154753594089 |
Call it from your code, or ask your agent
Set UPSCRAPE_API_KEY to your key and copy a working request.
curl --request POST \ --url https://data.upscrape.com/execute \ --header "Authorization: Bearer $UPSCRAPE_API_KEY" \ --header "Content-Type: application/json" \ --header "Prefer: wait=30" \ --data '{ "capability": "pinterest.user.get", "input": { "url": "https://www.pinterest.com/natlparkservice/" }}'
import jsonimport osimport requestspayload = json.loads(r'''{ "capability": "pinterest.user.get", "input": { "url": "https://www.pinterest.com/natlparkservice/" }}''')response = requests.post( "https://data.upscrape.com/execute", headers={ "Authorization": f"Bearer {os.environ['UPSCRAPE_API_KEY']}", "Content-Type": "application/json", "Prefer": "wait=30", }, json=payload,)response.raise_for_status()print(json.dumps(response.json(), indent=2))
const response = await fetch("https://data.upscrape.com/execute", { method: "POST", headers: { "Authorization": `Bearer ${process.env.UPSCRAPE_API_KEY}`, "Content-Type": "application/json", "Prefer": "wait=30", }, body: JSON.stringify({ "capability": "pinterest.user.get", "input": { "url": "https://www.pinterest.com/natlparkservice/" }}),});if (!response.ok) { throw new Error(`Upscrape request failed: ${response.status}`);}console.log(JSON.stringify(await response.json(), null, 2));
https://data.upscrape.com/mcp
Use Upscrape to look up the National Park Service on Pinterest (pinterest.com/natlparkservice). How many followers does it have, and is it a verified partner?
More from the Pinterest API
Pinterest User API FAQ
The short answers. The docs have the long ones.
How much does the Pinterest User API cost?
1 credit per successful call, shown before it runs. You buy credits once, and paid credits never expire.
What do I send?
Send url. The input fields below list every option with its type and limits.
Do I need a Pinterest login?
No. It reads public Pinterest data; nothing runs on your account.
Can my AI agent call it?
Yes, over MCP: the agent finds pinterest.user.get, checks its price and runs it with the same credits as the REST API.
Your first Pinterest call is free.
Up to 100 free credits to start, no card needed.