String docs
Site integrations

Pinterest

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
ActionDescriptionListed price
profileRead 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
boardsRead 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
pinsRead 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/profile

Input

Unknown fields are rejected.

FieldTypeDescription
usernamestringRequired. 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:

FieldTypeDescription
usernamestring—
urlstringThe profile's pinterest.com page.
idstring | null—
fullNamestring | null—
aboutstring | nullThe profile's about text, as the profile writes it.
websiteUrlstring | nullThe website the profile links.
websiteVerifiedboolean | nullWhether Pinterest verified the profile owns its website.
instagramUrlstring | nullThe Instagram account the profile linked, when it linked one.
followerCountinteger | null—
followingCountinteger | null—
pinCountinteger | nullPinterest'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.
verifiedMerchantboolean | nullWhether Pinterest verified the account as a merchant, whose pinCount includes its catalog.
boardCountinteger | null—
createdAtstring | nullWhen the account was created, RFC 3339 in UTC.
lastPinSavedAtstring | nullWhen the profile last saved a pin, RFC 3339 in UTC.
imageUrlstring | nullThe profile picture; absent while it is Pinterest's default.
verifiedboolean | nullWhether Pinterest shows the profile's verified-identity check.
privateboolean | nullWhether 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/boards

Input

Unknown fields are rejected.

FieldTypeDescription
usernamestringRequired. The profile's username, such as marthastewart, its pinterest.com URL or a pin.it share link to it. At least 1 character.
pagesintegerThe 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:

FieldTypeDescription
idstring—
namestring—
urlstring | nullThe board's pinterest.com page.
descriptionstring | null—
pinCountinteger | null—
sectionCountinteger | null—
followerCountinteger | null—
collaborativeboolean | nullWhether other people pin to the board too.
createdAtstring | nullWhen the board was created, RFC 3339 in UTC.
coverImageUrlstring | null—
ownerstring | nullThe 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/pins

Input

Unknown fields are rejected.

FieldTypeDescription
usernamestringRequired. The profile's username, such as marthastewart, its pinterest.com URL or a pin.it share link to it. At least 1 character.
pagesintegerThe 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:

FieldTypeDescription
idstring—
urlstringThe pin's pinterest.com page.
savedAtstring | nullWhen 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.
repinboolean | nullWhether the profile saved someone else's pin rather than pinning it first.
creatorstring | nullThe username of whoever first pinned it, when Pinterest names one.
titlestring | null—
descriptionstring | null—
linkstring | nullThe outbound page the pin links, often a product or recipe.
domainstring | nullThe outbound link's domain.
imageUrlstring | null—
boardNamestring | nullThe board the pin is saved to.
boardUrlstring | null—
pinnerstring | nullThe username of whoever saved the pin.
isVideoboolean | null—
productNamestring | nullA product pin's product name.
pricenumber | nullA product pin's price, in currency.
currencystring | nullA product pin's ISO 4217 currency, such as USD.
inStockboolean | nullWhether a product pin's offer is in stock.
merchantstring | nullThe 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.