Pinterest profiles, their boards and the pins they saved, as Pinterest's logged-out web app answers: a profile's name, about text, website and linked Instagram, every board with its name and pin count, and each saved pin's title, description, outbound link, board and save time.
Call these actions with your String API key; see Authentication. Every call answers with the envelope described in Responses & errors, whose data holds the rows below.
- Site:
pinterest - Version:
1.0.0 - Reads from:
pinterest.com,pin.it
| Action | Description | Listed price |
|---|---|---|
profile | Read a Pinterest profile: its name, about text, website, linked Instagram account, follower, following, pin and board counts, when it was created and when it last saved a pin, and whether it is verified or private. | Billed per request at your plan's rates |
boards | Read a Pinterest profile's public boards, most recently pinned to first: each board's name, description, pin and section counts, followers, whether it is collaborative and when it was created. | Billed per request at your plan's rates |
pins | Read the pins a Pinterest profile saved, newest first: each pin's title, description, outbound link and its domain, image, the board it is saved to, when it was saved, whether it is a repin and who first pinned it, and for a product pin its name, price, currency, stock and merchant. | Billed per request at your plan's rates |
profile
Read a Pinterest profile: its name, about text, website, linked Instagram account, follower, following, pin and board counts, when it was created and when it last saved a pin, and whether it is verified or private.
POST https://request.usestring.ai/v1/integrations/pinterest/profileInput
Unknown fields are rejected.
| Field | Type | Description |
|---|---|---|
username | string | Required. The profile's username, such as marthastewart, its pinterest.com URL or a pin.it share link to it. At least 1 character. |
Output
data is an array of rows, one per result. Each row has:
| Field | Type | Description |
|---|---|---|
username | string | — |
url | string | The profile's pinterest.com page. |
id | string | null | — |
fullName | string | null | — |
about | string | null | The profile's about text, as the profile writes it. |
websiteUrl | string | null | The website the profile links. |
websiteVerified | boolean | null | Whether Pinterest verified the profile owns its website. |
instagramUrl | string | null | The Instagram account the profile linked, when it linked one. |
followerCount | integer | null | — |
followingCount | integer | null | — |
pinCount | integer | null | Pinterest's own pin total for the account. For a verified merchant it counts its product-catalog pins, which can be millions above the pins on its boards. |
verifiedMerchant | boolean | null | Whether Pinterest verified the account as a merchant, whose pinCount includes its catalog. |
boardCount | integer | null | — |
createdAt | string | null | When the account was created, RFC 3339 in UTC. |
lastPinSavedAt | string | null | When the profile last saved a pin, RFC 3339 in UTC. |
imageUrl | string | null | The profile picture; absent while it is Pinterest's default. |
verified | boolean | null | Whether Pinterest shows the profile's verified-identity check. |
private | boolean | null | Whether the profile exists but is private. |
Example
curl https://request.usestring.ai/v1/integrations/pinterest/profile \
-H "Authorization: Bearer $STRING_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"username": "marthastewart"
}'data starts with these rows:
[
{
"username": "marthastewart",
"url": "https://www.pinterest.com/marthastewart/",
"id": "32088353503445352",
"fullName": "Martha Stewart",
"about": "Daily recipes, crafts, and inspiration from Martha Stewart.",
"websiteUrl": "http://marthastewart.com",
"websiteVerified": true,
"instagramUrl": "https://www.instagram.com/marthastewart",
"followerCount": 1867768,
"followingCount": 321,
"pinCount": 105785,
"verifiedMerchant": false,
"boardCount": 174,
"createdAt": "2011-09-15T07:56:17Z",
"lastPinSavedAt": "2026-11-11T03:00:14Z",
"imageUrl": "https://i.pinimg.com/280x280_RS/c8/11/4c/c8114c783347e27daef00e5d4a6ac4f3.jpg",
"verified": true,
"private": false
}
]Requests and billing
- Requests: 1 Web Access request per call, plus up to 1 setup request per call.
- Billing:
passthrough. Each request the action makes bills at its own rate on your plan; there is no separate charge for the action. See Pricing.
boards
Read a Pinterest profile's public boards, most recently pinned to first: each board's name, description, pin and section counts, followers, whether it is collaborative and when it was created.
POST https://request.usestring.ai/v1/integrations/pinterest/boardsInput
Unknown fields are rejected.
| Field | Type | Description |
|---|---|---|
username | string | Required. The profile's username, such as marthastewart, its pinterest.com URL or a pin.it share link to it. At least 1 character. |
pages | integer | The most pages to read, 1 to 20, 25 rows a page. Defaults to 2. From 1 to 20. |
Output
data is an array of rows, one per result. Each row has:
| Field | Type | Description |
|---|---|---|
id | string | — |
name | string | — |
url | string | null | The board's pinterest.com page. |
description | string | null | — |
pinCount | integer | null | — |
sectionCount | integer | null | — |
followerCount | integer | null | — |
collaborative | boolean | null | Whether other people pin to the board too. |
createdAt | string | null | When the board was created, RFC 3339 in UTC. |
coverImageUrl | string | null | — |
owner | string | null | The username of the board's owner. |
Example
curl https://request.usestring.ai/v1/integrations/pinterest/boards \
-H "Authorization: Bearer $STRING_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"username": "marthastewart",
"pages": 1
}'data starts with these rows:
[
{
"id": "32088284784058747",
"name": "#LetsCelebrate Pin Party",
"url": "https://www.pinterest.com/marthastewart/letscelebrate-pin-party/",
"description": "Repin your favorite party on this board with #LetsCelebrate in the caption for the chance to win one of 10 celebrations-in-a-box we're giving away. The blogger who is repinned the most will receive a feature on MarthaStewart.com and a $250 JCP gift card.",
"pinCount": 1153,
"sectionCount": 0,
"followerCount": 1507425,
"collaborative": true,
"createdAt": "2013-06-05T14:01:03Z",
"coverImageUrl": "https://i.pinimg.com/custom_covers/200x150/32088284784058747_1411658070.jpg",
"owner": "marthastewart"
},
{
"id": "32088284784029199",
"name": "American Made",
"url": "https://www.pinterest.com/marthastewart/american-made/",
"description": "Inspire. Make. Create. The maker movement starts here: http://Martha.ms/5frS #AmericanMadeAwards",
"pinCount": 299,
"sectionCount": 0,
"followerCount": 1507180,
"collaborative": true,
"createdAt": "2012-08-15T14:44:33Z",
"coverImageUrl": "https://i.pinimg.com/custom_covers/200x150/32088284784029199_1419268822.jpg",
"owner": "marthastewart"
}
]Requests and billing
- Requests: 1 Web Access request per result page, plus up to 1 setup request per call.
- Billing:
passthrough. Each request the action makes bills at its own rate on your plan; there is no separate charge for the action. See Pricing.
pins
Read the pins a Pinterest profile saved, newest first: each pin's title, description, outbound link and its domain, image, the board it is saved to, when it was saved, whether it is a repin and who first pinned it, and for a product pin its name, price, currency, stock and merchant.
POST https://request.usestring.ai/v1/integrations/pinterest/pinsInput
Unknown fields are rejected.
| Field | Type | Description |
|---|---|---|
username | string | Required. The profile's username, such as marthastewart, its pinterest.com URL or a pin.it share link to it. At least 1 character. |
pages | integer | The most pages to read, 1 to 20, 25 rows a page. Defaults to 2. From 1 to 20. |
Output
data is an array of rows, one per result. Each row has:
| Field | Type | Description |
|---|---|---|
id | string | — |
url | string | The pin's pinterest.com page. |
savedAt | string | null | When this profile saved the pin, RFC 3339 in UTC. A save is its own pin with its own id, so for a repin this is the save, not when the original was first pinned. |
repin | boolean | null | Whether the profile saved someone else's pin rather than pinning it first. |
creator | string | null | The username of whoever first pinned it, when Pinterest names one. |
title | string | null | — |
description | string | null | — |
link | string | null | The outbound page the pin links, often a product or recipe. |
domain | string | null | The outbound link's domain. |
imageUrl | string | null | — |
boardName | string | null | The board the pin is saved to. |
boardUrl | string | null | — |
pinner | string | null | The username of whoever saved the pin. |
isVideo | boolean | null | — |
productName | string | null | A product pin's product name. |
price | number | null | A product pin's price, in currency. |
currency | string | null | A product pin's ISO 4217 currency, such as USD. |
inStock | boolean | null | Whether a product pin's offer is in stock. |
merchant | string | null | The site a product or rich pin comes from, such as Pottery Barn. |
Example
curl https://request.usestring.ai/v1/integrations/pinterest/pins \
-H "Authorization: Bearer $STRING_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"username": "marthastewart",
"pages": 1
}'data starts with these rows:
[
{
"id": "32088216099812277",
"url": "https://www.pinterest.com/pin/32088216099812277/",
"savedAt": "2026-11-11T03:00:14Z",
"repin": false,
"creator": "marthastewart",
"title": "Can You Throw Used Batteries in the Trash? Here’s How to Dispose of Them Safely",
"description": "Can household batteries go in the garbage? Waste experts share what to recycle, what may be discarded, and why it matters.",
"link": "https://www.marthastewart.com/how-to-dispose-of-batteries-12200478?utm_campaign=marthastewartliving_6af3da3df6799500016809ab&utm_content=textoverlay&utm_medium=social&utm_source=pinterest.com",
"domain": "marthastewart.com",
"imageUrl": "https://i.pinimg.com/736x/f1/06/d7/f106d7330a2f7a58734a579cfa7dd1cf.jpg",
"boardName": "Home Decor",
"boardUrl": "https://www.pinterest.com/marthastewart/home-decor/",
"pinner": "marthastewart",
"isVideo": false,
"productName": null,
"price": null,
"currency": null,
"inStock": null,
"merchant": null
},
{
"id": "32088216099812059",
"url": "https://www.pinterest.com/pin/32088216099812059/",
"savedAt": "2026-11-11T02:00:04Z",
"repin": false,
"creator": "marthastewart",
"title": "These 2027 Home Trends Are About to Be Everywhere, According to Zillow",
"description": "The real estate marketplace just released its 2027 Home Trends Report, which offers an early look at the amenities, upgrades, and design details that are poised to be everywhere in 2027. Here’s what the data revealed.",
"link": "https://www.marthastewart.com/zillow-home-trends-2027-12246736?utm_campaign=marthastewart_6af3cc23f6799500016809a3&utm_content=verticalimage&utm_medium=social&utm_source=pinterest.com&utm_term=202611",
"domain": "marthastewart.com",
"imageUrl": "https://i.pinimg.com/736x/d4/c6/34/d4c634c1691a45333bffa246c4b7a388.jpg",
"boardName": "Gardening and Plants",
"boardUrl": "https://www.pinterest.com/marthastewart/gardening-and-plants/",
"pinner": "marthastewart",
"isVideo": false,
"productName": null,
"price": null,
"currency": null,
"inStock": null,
"merchant": null
}
]Requests and billing
- Requests: 1 Web Access request per result page, plus up to 1 setup request per call.
- Billing:
passthrough. Each request the action makes bills at its own rate on your plan; there is no separate charge for the action. See Pricing.