# Pinterest Profile Pins API. Pins, page by page. Every pin an account saved or created, page by page. We handle the proxies, blocks and platform changes. [Get API key](https://socialtap.dev/signup/?next=%2Fplayground%2F%3Fendpoint%3Dpinterest.pins) ## Pinterest Profile Pins API at a glance Returns a public Pinterest account's pins from its username, profile link or ID, newest first, page by page. Each pin has its title, description, hashtags, picture or video files, exact saves, reactions and comments, the page it links to, its board and the account that first pinned it. List every pin the account saved, or only the ones it created. GET `/v1/pinterest/pins` [Read the API reference](https://socialtap.dev/docs/reference/pinterest/pins/index.md) - **1 credit** per page, $0.75–$1.97 per 1,000 pages - **22 typed fields** null when unknown - **25** pins per page, newest first - **`handle`** is all it needs, e.g. `pinterest` ## Send one request. Get up to 25 pins back. Copy the request in your language, or hand it to your agent. Sign up for an API key and your first 100 credits are free. `$ npm install socialtap` `handle = pinterest` [Open in playground](https://socialtap.dev/playground/?endpoint=pinterest.pins) cURL: ```shell curl 'https://socialtap.dev/v1/pinterest/pins?handle=pinterest' \ -H "x-api-key: $SOCIALTAP_API_KEY" ``` TypeScript SDK: ```typescript import { SocialTap } from "socialtap"; const client = new SocialTap(); // apiKey defaults to process.env.SOCIALTAP_API_KEY const res = await client.pinterest.pins.list({ handle: "pinterest" }); console.log(res.data); console.log(res.credits.charged, res.meta.request_id); ``` Node.js (fetch): ```javascript const params = new URLSearchParams({ handle: "pinterest", }); const res = await fetch(`https://socialtap.dev/v1/pinterest/pins?${params}`, { headers: { "x-api-key": process.env.SOCIALTAP_API_KEY ?? "" }, }); const body = await res.json(); if (!res.ok) throw new Error(`${body.error.code}: ${body.error.message}`); const { data, page, meta } = body; console.log(data, meta.credits_charged); ``` Python (requests): ```python import os import requests res = requests.get( "https://socialtap.dev/v1/pinterest/pins", params={"handle": "pinterest"}, headers={"x-api-key": os.environ["SOCIALTAP_API_KEY"]}, ) body = res.json() if not res.ok: raise RuntimeError(f"{body['error']['code']}: {body['error']['message']}") data, page, meta = body["data"], body["page"], body["meta"] print(data, meta["credits_charged"]) ``` Go (net/http): ```go package main import ( "encoding/json" "fmt" "log" "net/http" "net/url" "os" ) func main() { q := url.Values{} q.Set("handle", "pinterest") req, err := http.NewRequest("GET", "https://socialtap.dev/v1/pinterest/pins?"+q.Encode(), nil) if err != nil { log.Fatal(err) } req.Header.Set("x-api-key", os.Getenv("SOCIALTAP_API_KEY")) res, err := http.DefaultClient.Do(req) if err != nil { log.Fatal(err) } defer res.Body.Close() var body struct { Data json.RawMessage `json:"data"` Page json.RawMessage `json:"page"` Meta map[string]any `json:"meta"` Error *struct { Code string `json:"code"` Message string `json:"message"` } `json:"error"` } if err := json.NewDecoder(res.Body).Decode(&body); err != nil { log.Fatal(err) } if body.Error != nil { log.Fatalf("%s: %s", body.Error.Code, body.Error.Message) } fmt.Println(string(body.Data), body.Meta["credits_charged"]) } ``` 200 OK: ```json { "data": [ { "approximate_fields": [], "author": { "avatar_url": "https://i.pinimg.com/280x280_RS/1c/b5/61/1cb561c8e7b9c709f78d110a4b5f0863.jpg", "display_name": "Pinterest", "id": "424605208526455283", "is_verified": true, "url": "https://www.pinterest.com/pinterest/", "username": "pinterest" }, "coauthors": [], "duration_ms": null, "hashtags": [], "id": "424605071146306109", "is_nsfw": null, "is_pinned": null, "is_sponsored": false, "language": null, "media": [ { "alt_text": null, "duration_ms": null, "expires_at": null, "height": 1599, "thumbnail_url": "https://i.pinimg.com/originals/e3/b2/88/e3b288ad73798578086a4bcafde8eafd.jpg", "type": "image", "url": "https://i.pinimg.com/originals/e3/b2/88/e3b288ad73798578086a4bcafde8eafd.jpg", "width": 1199 } ], "mentions": [], "metrics": { "comment_count": 0, "like_count": 9, "quote_count": null, "repost_count": null, "save_count": 323, "share_count": null, "view_count": null }, "platform": "pinterest", "platform_specific": { "pinterest": { "author_follower_count": 6269070, "board": { "id": "424605139808130646", "title": "Easy and chic holiday nail ideas", "url": "https://www.pinterest.com/pinterest/easy-and-chic-holiday-nail-ideas/" }, "caption_languages": [], "domain": null, "dominant_color": "#563a27", "interests": [], "is_ad": false, "is_author_verified_merchant": false, "is_repin": true, "link_url": null, "original_pinner": { "avatar_url": "https://i.pinimg.com/280x280_RS/4a/7e/c4/4a7ec41a64ea9df0a2a34d0e22834c9c.jpg", "display_name": "Lauren", "id": "631770791385517160", "is_verified": false, "url": "https://www.pinterest.com/lrnglenn/", "username": "lrnglenn" }, "repin_count": null, "rich_type": null } }, "platform_type": "idea_pin", "published_at": "2026-11-09T19:14:02Z", "text": null, "thumbnail_url": "https://i.pinimg.com/originals/e3/b2/88/e3b288ad73798578086a4bcafde8eafd.jpg", "title": "🪩✨", "type": "image", "unknown_fields": [ "platform_specific.pinterest.interests" ], "url": "https://www.pinterest.com/pin/424605071146306109/" }, { "approximate_fields": [], "author": { "avatar_url": "https://i.pinimg.com/280x280_RS/1c/b5/61/1cb561c8e7b9c709f78d110a4b5f0863.jpg", "display_name": "Pinterest", "id": "424605208526455283", "is_verified": true, "url": "https://www.pinterest.com/pinterest/", "username": "pinterest" }, "coauthors": [], "duration_ms": null, "hashtags": [ "beyoncé", "nailtech" ], "id": "424605071146306108", "is_nsfw": null, "is_pinned": null, "is_sponsored": false, "language": null, "media": [ { "alt_text": null, "duration_ms": null, "expires_at": null, "height": 1666, "thumbnail_url": "https://i.pinimg.com/originals/e3/9e/69/e39e69304ea39fffbfa904935faff40b.jpg", "type": "image", "url": "https://i.pinimg.com/originals/e3/9e/69/e39e69304ea39fffbfa904935faff40b.jpg", "width": 1440 } ], "mentions": [], "metrics": { "comment_count": 0, "like_count": 8, "quote_count": null, "repost_count": null, "save_count": 187, "share_count": null, "view_count": null }, "platform": "pinterest", "platform_specific": { "pinterest": { "author_follower_count": 6269070, "board": { "id": "424605139808130646", "title": "Easy and chic holiday nail ideas", "url": "https://www.pinterest.com/pinterest/easy-and-chic-holiday-nail-ideas/" }, "caption_languages": [], "domain": "instagram.com", "dominant_color": "#93897f", "interests": [], "is_ad": false, "is_author_verified_merchant": false, "is_repin": true, "link_url": "https://www.instagram.com/p/DJvUrGMgyJQ/", "original_pinner": { "avatar_url": "https://i.pinimg.com/280x280_RS/7d/d4/67/7dd467eb766ae86468f9423e86ff1743.jpg", "display_name": "Nicxbeauttyy", "id": "1009510210131239142", "is_verified": false, "url": "https://www.pinterest.com/nicxbeautty/", "username": "nicxbeautty" }, "repin_count": null, "rich_type": null } }, "platform_type": "pin", "published_at": "2026-11-09T19:13:44Z", "text": "A moment for the disco nails #beyoncé #nailtech", "thumbnail_url": "https://i.pinimg.com/originals/e3/9e/69/e39e69304ea39fffbfa904935faff40b.jpg", "title": null, "type": "image", "unknown_fields": [ "platform_specific.pinterest.interests" ], "url": "https://www.pinterest.com/pin/424605071146306108/" }, { "approximate_fields": [], "author": { "avatar_url": "https://i.pinimg.com/280x280_RS/1c/b5/61/1cb561c8e7b9c709f78d110a4b5f0863.jpg", "display_name": "Pinterest", "id": "424605208526455283", "is_verified": true, "url": "https://www.pinterest.com/pinterest/", "username": "pinterest" }, "coauthors": [], "duration_ms": null, "hashtags": [], "id": "424605071146306107", "is_nsfw": null, "is_pinned": null, "is_sponsored": false, "language": null, "media": [ { "alt_text": null, "duration_ms": null, "expires_at": null, "height": 1211, "thumbnail_url": "https://i.pinimg.com/originals/80/d8/c9/80d8c92c74168ea8c66d5681d0b719d4.jpg", "type": "image", "url": "https://i.pinimg.com/originals/80/d8/c9/80d8c92c74168ea8c66d5681d0b719d4.jpg", "width": 1014 } ], "mentions": [], "metrics": { "comment_count": 0, "like_count": 5, "quote_count": null, "repost_count": null, "save_count": 189, "share_count": null, "view_count": null }, "platform": "pinterest", "platform_specific": { "pinterest": { "author_follower_count": 6269070, "board": { "id": "424605139808130646", "title": "Easy and chic holiday nail ideas", "url": "https://www.pinterest.com/pinterest/easy-and-chic-holiday-nail-ideas/" }, "caption_languages": [], "domain": null, "dominant_color": "#aa8878", "interests": [], "is_ad": false, "is_author_verified_merchant": false, "is_repin": true, "link_url": null, "original_pinner": { "avatar_url": "https://i.pinimg.com/280x280_RS/81/1c/32/811c32b5bf66eecd20d7185caf897909.jpg", "display_name": "Kimberly Reyn", "id": "431712451688407077", "is_verified": false, "url": "https://www.pinterest.com/amazon_chic/", "username": "amazon_chic" }, "repin_count": null, "rich_type": null } }, "platform_type": "idea_pin", "published_at": "2026-11-09T19:13:38Z", "text": "Nail idea for the holidays", "thumbnail_url": "https://i.pinimg.com/originals/80/d8/c9/80d8c92c74168ea8c66d5681d0b719d4.jpg", "title": "Christmas | Holiday Set", "type": "image", "unknown_fields": [ "platform_specific.pinterest.interests" ], "url": "https://www.pinterest.com/pin/424605071146306107/" } ], "page": { "has_more": true, "next_cursor": "c1.EXAMPLE_CURSOR", "next_cursor_expires_at": "2026-10-26T12:00:00Z", "end_reason": null }, "meta": { "request_id": "req_3f9c2a7d1e8b4c6a9f0e2d4b6a8c0e1f", "platform": "pinterest", "source": "api", "is_cached": false, "credits_charged": 1, "latency_ms": 0, "fetched_at": "2026-10-25T12:00:00Z", "input": { "kind": "profile", "id": "424605208526455283", "url": "https://www.pinterest.com/pinterest/" }, "credits_remaining": 9999, "client_request_id": null, "warnings": [] } } ``` Long arrays and strings are shortened here. Real responses are complete. ## One schema on 21 platforms. The [response reference](https://socialtap.dev/docs/reference/pinterest/pins/index.md#response) lists every field, its type and when it is `null`. [See the full schema](https://socialtap.dev/resources/post/index.md). - ### Null means unknown A field Pinterest doesn't show is null, never zero or an empty string, so a real zero always means zero. - ### What it accepts The Pinterest account: its username (any case, with or without the @), its profile link (pinterest.com/\/, any of its tabs such as /_created/ or /_pins/, also on a country's site such as uk.pinterest.com or pinterest.co.uk) or its numeric ID. - ### Write one parser Pinterest, TikTok, Instagram and 18 more platforms answer in these fields, so the code that reads one reads them all. - **`platform`string**: Platform ID (tiktok, youtube, …). - **`id`string**: Platform-native post ID (string; Instagram shortcode, Reddit with its t3_ prefix). - **`url`string**: Canonical post URL. - **`type`string**: Normalized content shape. New values may be added; treat unknown values as other. - **`platform_type`string**: The platform's own product label, lowercase (reel, short, story, live, tweet, …). - **`title`string**: Headline (YouTube title, Reddit title); null on caption-only platforms. - **`text`string**: Caption, description or body as plain text. - **`language`string**: BCP-47 language of text, when the platform states it. Live data from 33 platforms. [TikTok](https://socialtap.dev/apis/tiktok/index.md) · [Instagram](https://socialtap.dev/apis/instagram/index.md) · [Facebook](https://socialtap.dev/apis/facebook/index.md) · [YouTube](https://socialtap.dev/apis/youtube/index.md) · [Reddit](https://socialtap.dev/apis/reddit/index.md) · [Threads](https://socialtap.dev/apis/threads/index.md) · [Spotify](https://socialtap.dev/apis/spotify/index.md) · [Amazon](https://socialtap.dev/apis/amazon/index.md) · [Apple Music](https://socialtap.dev/apis/applemusic/index.md) · [Pinterest](https://socialtap.dev/apis/pinterest/index.md) · [Rumble](https://socialtap.dev/apis/rumble/index.md) · [X](https://socialtap.dev/apis/x/index.md) · [Bluesky](https://socialtap.dev/apis/bluesky/index.md) · [Twitch](https://socialtap.dev/apis/twitch/index.md) · [LinkedIn](https://socialtap.dev/apis/linkedin/index.md) · [Telegram](https://socialtap.dev/apis/telegram/index.md) · [TikTok Shop](https://socialtap.dev/apis/tiktokshop/index.md) · [Kwai](https://socialtap.dev/apis/kwai/index.md) · [Snapchat](https://socialtap.dev/apis/snapchat/index.md) · [SoundCloud](https://socialtap.dev/apis/soundcloud/index.md) · [Truth Social](https://socialtap.dev/apis/truthsocial/index.md) · [Kick](https://socialtap.dev/apis/kick/index.md) · [Komi](https://socialtap.dev/apis/komi/index.md) · [Lnk.Bio](https://socialtap.dev/apis/linkbio/index.md) · [Linkme](https://socialtap.dev/apis/linkme/index.md) · [Linktree](https://socialtap.dev/apis/linktree/index.md) · [Pillar](https://socialtap.dev/apis/pillar/index.md) · [TikTok Ad Library](https://socialtap.dev/apis/tiktok-ad-library/index.md) · [Facebook Ad Library](https://socialtap.dev/apis/facebook-ad-library/index.md) · [Facebook Events](https://socialtap.dev/apis/facebook-events/index.md) · [Facebook Marketplace](https://socialtap.dev/apis/facebook-marketplace/index.md) · [Google Ads Transparency Center](https://socialtap.dev/apis/google-ads-transparency/index.md) · [LinkedIn Ad Library](https://socialtap.dev/apis/linkedin-ad-library/index.md) ## What teams build with the Pinterest Profile Pins API. - ### Track what a brand pins each week - ### Collect a creator's pins and their saves - ### Find the sites an account sends traffic to - ### Download an account's pin pictures and videos ## Good to know before you build. - tab=saved lists the account's Pins tab, which holds the pins it saved from others too: each of those has platform_specific.pinterest.is_repin true and names who pinned it first in original_pinner. - Pinterest orders the Pins tab by when each pin was saved, but can list a pin out of that order. So since and until filter its pages without ending the walk; on tab=created, which is in strict order, paging stops once since is reached. - Pinterest leaves an idea pin's description out of these lists, so its text is null here. The Pinterest Pin API returns it, with the pin's interests, which are listed in unknown_fields here. - metrics.save_count counts the saves of every pin of the same picture or video. metrics.share_count is null, as is platform_specific.pinterest.repin_count on tab=saved: those lists don't carry them. - When Pinterest's main API fails on a first page, the pins come from its embed API: no title, date, reactions or comments, a carousel shows only its cover, and the list stops there with page.end_reason platform_limit. ## 1 credit per page. Failed requests are free. Buy credits once and spend them on any endpoint, on any platform. [Plans and packs](https://socialtap.dev/pricing/index.md) · [How this endpoint is priced](https://socialtap.dev/docs/reference/pinterest/pins/index.md#pricing) · [How credits work](https://socialtap.dev/docs/credits/index.md) | Source | Price per successful page | Per 1,000 pages | | --- | --- | --- | | Platform API `api` | 1 credit | $0.75–$1.97 | - Cache hits are free. - Credits from packs and top-ups never expire. - A monthly plan's credits are spent first, and what is left of them ends at each renewal. - Prices exclude tax: sales tax is added at checkout where it applies. - Outside the US, plans and packs are sold to businesses: checkout asks for your VAT, GST or other business tax ID. ## Questions about the Pinterest Profile Pins API. More in the [API reference](https://socialtap.dev/docs/reference/pinterest/pins/index.md). **Does it include pins the account saved from others?** Yes, with tab=saved, the default. Send tab=created for only the pins the account made itself. **Can I send the account's ID instead of its username?** Yes. The numeric ID that pins and boards give their pinner works, as does any link to the account's profile or its tabs. **How much does the Pinterest Profile Pins API cost?** A page of up to 25 pins costs 1 credit. Every successful page is charged, empty pages included. SocialTap credits cost $0.75–$1.97 per 1,000, depending on the plan or pack. **How do I get the next page?** Repeat the same request with cursor set to page.next_cursor from the previous response, keeping the other parameters. When page.has_more is false there are no more pages. Cursors expire after 24 hours. Other platforms ## Posts on 20 more platforms. - [TikTok Post API](https://socialtap.dev/apis/tiktok/post/index.md) (1 credit · `GET /v1/tiktok/post`) - [Instagram Post API](https://socialtap.dev/apis/instagram/post/index.md) (1 credit · `GET /v1/instagram/post`) - [Facebook Post API](https://socialtap.dev/apis/facebook/post/index.md) (1 credit · `GET /v1/facebook/post`) - [YouTube Video API](https://socialtap.dev/apis/youtube/post/index.md) (1 credit · `GET /v1/youtube/post`) - [Reddit Post API](https://socialtap.dev/apis/reddit/post/index.md) (1 credit · `GET /v1/reddit/post`) - [Threads Post API](https://socialtap.dev/apis/threads/post/index.md) (1 credit · `GET /v1/threads/post`) - [Spotify Track API](https://socialtap.dev/apis/spotify/track/index.md) (1 credit · `GET /v1/spotify/track`) - [Amazon Shop Posts API](https://socialtap.dev/apis/amazon/shop_posts/index.md) (1 credit / page · `GET /v1/amazon/shop_posts`) - [Apple Music Track API](https://socialtap.dev/apis/applemusic/track/index.md) (1 credit · `GET /v1/applemusic/track`) - [Rumble Video API](https://socialtap.dev/apis/rumble/post/index.md) (1 credit · `GET /v1/rumble/post`) - [X (Twitter) Post API](https://socialtap.dev/apis/x/post/index.md) (1 credit · `GET /v1/x/post`) - [Bluesky Post API](https://socialtap.dev/apis/bluesky/post/index.md) (1 credit · `GET /v1/bluesky/post`) - [Twitch Video and Clip API](https://socialtap.dev/apis/twitch/video/index.md) (1 credit · `GET /v1/twitch/video`) - [LinkedIn Post API](https://socialtap.dev/apis/linkedin/post/index.md) (1 credit · `GET /v1/linkedin/post`) - [Telegram Post API](https://socialtap.dev/apis/telegram/post/index.md) (1 credit · `GET /v1/telegram/post`) - [Kwai Post API](https://socialtap.dev/apis/kwai/post/index.md) (1 credit · `GET /v1/kwai/post`) - [Snapchat Spotlight API](https://socialtap.dev/apis/snapchat/spotlight/index.md) (1 credit · `GET /v1/snapchat/spotlight`) - [SoundCloud Track API](https://socialtap.dev/apis/soundcloud/track/index.md) (1 credit · `GET /v1/soundcloud/track`) - [Truth Social Post API](https://socialtap.dev/apis/truthsocial/post/index.md) (1 credit · `GET /v1/truthsocial/post`) - [Kick Clip API](https://socialtap.dev/apis/kick/post/index.md) (1 credit · `GET /v1/kick/post`) More Pinterest ## Pinterest API. 10 endpoints, one key. - [Pinterest Pin API](https://socialtap.dev/apis/pinterest/pin/index.md) (1 credit · `GET /v1/pinterest/pin`) - [Pinterest Search API](https://socialtap.dev/apis/pinterest/search_pins/index.md) (1 credit / page · `GET /v1/pinterest/search_pins`) - [Pinterest Board Pins API](https://socialtap.dev/apis/pinterest/board_pins/index.md) (1 credit / page · `GET /v1/pinterest/board_pins`) - [Pinterest Profile API](https://socialtap.dev/apis/pinterest/profile/index.md) (1 credit · `GET /v1/pinterest/profile`) - [Pinterest Board API](https://socialtap.dev/apis/pinterest/board/index.md) (1 credit · `GET /v1/pinterest/board`) - [Pinterest Boards API](https://socialtap.dev/apis/pinterest/boards/index.md) (1 credit / page · `GET /v1/pinterest/boards`) - [Pinterest Topic API](https://socialtap.dev/apis/pinterest/topic/index.md) (1 credit · `GET /v1/pinterest/topic`) - [Pinterest Trends API](https://socialtap.dev/apis/pinterest/top_trends/index.md) (1 credit / page · `GET /v1/pinterest/top_trends`) - [Pinterest URL Save Count API](https://socialtap.dev/apis/pinterest/web_page/index.md) (1 credit · `GET /v1/pinterest/web_page`) ## Try it on an account you know. Paste its handle or link in the playground, or copy the request into your code. 100free credits - No credit card - Failed requests are free - Works on all 218 endpoints [Start for free](https://socialtap.dev/signup/) [Read the docs](https://socialtap.dev/docs/index.md) --- [HTML version](https://socialtap.dev/apis/pinterest/pins/) · [Docs index for AI agents](https://socialtap.dev/llms.txt) · [All docs in one file](https://socialtap.dev/llms-full.txt)