Pinterest pin API
One request, one key: POST /v1/visual/pinterest/pin. The fields below are read from a real answer captured 19 November 2026, with the value each field had (long text cut, lists cut to three items); a call can return more or fewer fields depending on what the source holds. It is not invented.
Price
2 credits a call. One call is about $0.0196 and 1,000 calls are about $19.60 at the smallest paid plan's rate.Formula A call that comes back empty is not charged.
Try it free
This call is listed in the free browser demo, which runs it with no key and no sign-up, a few runs a day per visitor: open the demo. Or get 100 free credits to call it from your code.
What it returns
You send:
{
"url": "https://www.pinterest.com/pin/99360735500167749/"
}
| Field | Type | Value in the captured answer |
|---|---|---|
url | string | https://www.pinterest.com/pin/99360735500167749/ |
platform | string | |
extracted_at | string | 2026-11-18T20:36:55.402192+00:00 |
text | string | Have you heard of Pinterest? Yes right? What about ? I just read the first report of live pinning on Mashab... |
title | string | Next stop: Pinterest! |
description | string | Have you heard of Pinterest? Yes right? What about ? I just read the first report of live pinning on Mashab... |
author_name | string | Kent Brewster |
author_url | string | https://www.pinterest.com/kentbrew/ |
date_source | string | og_meta |
thumbnail_url | string | https://i.pinimg.com/736x/a7/66/56/a76656e966b1958f568d63c3f1c05aec.jpg |
images | list | ["https://i.pinimg.com/736x/a7/66/56/a76656e966b1958f568d63c3f1c05aec.jpg"] |
content_type | string | pin |
extras | object | {"oembed":{"version":"1.0","type":"rich","provider_name":"Pinterest","provider_url":"https://www.pinterest.... |
credits_used | number | 2 |
Measured on that call: 1084 ms.
Code
curl
curl -X POST https://api.foxapis.com/v1/visual/pinterest/pin \
-H "Authorization: Bearer YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"url":"https://www.pinterest.com/pin/99360735500167749/"}'Python
import requests
r = requests.post(
"https://api.foxapis.com/v1/visual/pinterest/pin",
headers={"Authorization": "Bearer YOUR_KEY"},
json={"url":"https://www.pinterest.com/pin/99360735500167749/"},
)
print(r.json())JavaScript
const r = await fetch("https://api.foxapis.com/v1/visual/pinterest/pin", {
method: "POST",
headers: { "Authorization": "Bearer YOUR_KEY", "Content-Type": "application/json" },
body: JSON.stringify({"url":"https://www.pinterest.com/pin/99360735500167749/"}),
});
console.log(await r.json());
n8n (HTTP Request node: paste it into a workflow)
{
"nodes": [
{
"name": "Pinterest pin",
"type": "n8n-nodes-base.httpRequest",
"typeVersion": 4,
"position": [
0,
0
],
"parameters": {
"method": "POST",
"url": "https://api.foxapis.com/v1/visual/pinterest/pin",
"sendHeaders": true,
"headerParameters": {
"parameters": [
{
"name": "Authorization",
"value": "Bearer YOUR_KEY"
}
]
},
"sendBody": true,
"specifyBody": "json",
"jsonBody": "{\"url\":\"https://www.pinterest.com/pin/99360735500167749/\"}"
}
}
],
"connections": {}
}
Assistants (Claude, ChatGPT, Cursor)
Connect the FoxAPIs server once; the tools it offers are listed on the MCP page.
claude mcp add --transport http foxapis https://foxapis.com/mcp \ --header "Authorization: Bearer YOUR_KEY"
Errors and limits
- 401: the key is missing or wrong.
- 402: out of credits; top up on the pricing page.
- 422: the input does not match; the answer names the field.
- 429: too many calls too fast; wait a moment and try again.
- 503: the source did not answer; nothing is charged. Live state: status.
Free to start: 100 credits, no card. Then from $10. Credits you buy never expire.
Get my free keySame category: Images · all APIs
How we calculate
- Price of one call and of 1,000 calls: The credits per call times the smallest paid plan's price per credit (its monthly price divided by its monthly credits), times 1,000 for the larger figure.
Data: scripts/data/endpoint-credits.json and plans.json, 2026-11-20. Every other figure on this page is copied from the record, not calculated by us.