# Pinterest Profile API. Send a handle or profile link. Exact followers, pins, boards and monthly views. We handle the proxies, blocks and platform changes. [Get API key](https://socialtap.dev/signup/?next=%2Fplayground%2F%3Fendpoint%3Dpinterest.profile) ## Pinterest Profile API at a glance Returns a public Pinterest account from its username, profile link or ID. It has exact follower, following, pin and board counts, its monthly views, the bio, website and linked Instagram account, the picture and cover, the join date and when it last saved a pin. Badges say whether it is verified, a business account or a verified merchant. GET `/v1/pinterest/profile` [Read the API reference](https://socialtap.dev/docs/reference/pinterest/profile/index.md) - **1 credit** per request, $0.75–$1.97 per 1,000 requests - **19 typed fields** null when unknown - **`handle`** is all it needs, e.g. `pinterest` - **100 credits** free when you sign up, no card, so you can build before you spend ## Send one request. Get 19 fields 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.profile) cURL: ```shell curl 'https://socialtap.dev/v1/pinterest/profile?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.profile.get({ 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/profile?${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, meta } = body; console.log(data, meta.credits_charged); ``` Python (requests): ```python import os import requests res = requests.get( "https://socialtap.dev/v1/pinterest/profile", 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, meta = body["data"], 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/profile?"+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"` 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": [ "platform_specific.pinterest.monthly_view_count" ], "avatar_url": "https://i.pinimg.com/280x280_RS/1c/b5/61/1cb561c8e7b9c709f78d110a4b5f0863.jpg", "banner_url": "https://i.pinimg.com/originals/68/e2/7f/68e27f34a51fda06520a4eca1c31a982.jpg", "bio": "Find your reason to go offline. 📌", "category": null, "country_code": null, "created_at": "2012-08-16T06:25:03Z", "display_name": "Pinterest", "external_links": [ { "title": null, "url": "http://www.pinterest.com" } ], "id": "424605208526455283", "is_private": false, "is_verified": true, "location": null, "metrics": { "follower_count": 6269072, "following_count": 314, "post_count": 98418, "total_like_count": null, "total_view_count": null }, "platform": "pinterest", "platform_specific": { "pinterest": { "all_following_count": 398, "interest_following_count": 0, "is_business_account": true, "is_verified_merchant": false, "is_website_verified": true, "last_post_at": "2026-11-09T19:14:02Z", "monthly_view_count": 10000000, "playlist_count": 168 } }, "type": "unknown", "unknown_fields": [], "url": "https://www.pinterest.com/pinterest/", "username": "pinterest" }, "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": [] } } ``` ## One schema on 27 platforms. The [response reference](https://socialtap.dev/docs/reference/pinterest/profile/index.md#response) lists every field, its type and when it is `null`. [See the full schema](https://socialtap.dev/resources/profile/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 /_saved/, 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 24 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 account ID (string; YouTube UC…, Reddit t2_…). - **`username`string**: Handle without the @; null when the account has none. - **`display_name`string**: Display name, channel title or page name; null when empty or not exposed. - **`url`string**: Canonical profile URL. - **`type`string**: Coarse account kind, as the platform labels it; unknown when it does not (TikTok labels organizations only). New values may be added; treat unknown values as unknown. - **`bio`string**: Profile bio, channel description or page about text; null when empty or not exposed. - **`avatar_url`string**: Profile picture URL (largest available). Platform CDN URLs can expire within hours. 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 API. - ### Track a brand's Pinterest followers over time - ### Find creators by audience size and monthly views - ### Check which shops are verified merchants - ### Find the website and Instagram behind an account ## Good to know before you build. - metrics.following_count counts the accounts it follows. platform_specific.pinterest.all_following_count adds the boards and interests it follows, and interest_following_count is the interests alone. The account's page shows all_following_count minus interest_following_count (accounts and boards), so its number can be more than metrics.following_count. - metrics.post_count is the pins Pinterest counts for the account. A shop's count includes its product catalog, so it can run far above the pins its boards show. - Pinterest shows monthly views above ten million only as more than that, so monthly_view_count is then ten million, listed in approximate_fields. An account that hides its views has null. - type is organization for a verified merchant (a shop Pinterest checked) and unknown for the rest: Pinterest marks business accounts, which creators have too, in is_business_account, and nothing else about the kind of account. - When Pinterest's main API fails, the account comes from its embed API: the ID, name, bio, picture and follower and pin counts alone, external_links listed in unknown_fields. ## 1 credit per request. 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/profile/index.md#pricing) · [How credits work](https://socialtap.dev/docs/credits/index.md) | Source | Price per successful request | Per 1,000 requests | | --- | --- | --- | | 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 API. More in the [API reference](https://socialtap.dev/docs/reference/pinterest/profile/index.md). **Can I look an account up by its ID?** Yes. Send the numeric ID Pinterest gives the account, as pins and boards name their pinner, and the answer has its username and link. **Does it return the account's pins or boards?** No. It returns the account itself; its pins and its boards each have an endpoint of their own, page by page. **How much does the Pinterest Profile API cost?** A request costs 1 credit. SocialTap credits cost $0.75–$1.97 per 1,000, depending on the plan or pack. Other platforms ## Profiles on 26 more platforms. - [TikTok Profile API](https://socialtap.dev/apis/tiktok/profile/index.md) (1 credit · `GET /v1/tiktok/profile`) - [Instagram Profile API](https://socialtap.dev/apis/instagram/profile/index.md) (1 credit · `GET /v1/instagram/profile`) - [Facebook Profile API](https://socialtap.dev/apis/facebook/profile/index.md) (1 credit · `GET /v1/facebook/profile`) - [YouTube Channel API](https://socialtap.dev/apis/youtube/profile/index.md) (1 credit · `GET /v1/youtube/profile`) - [Reddit Profile API](https://socialtap.dev/apis/reddit/profile/index.md) (1 credit · `GET /v1/reddit/profile`) - [Threads Profile API](https://socialtap.dev/apis/threads/profile/index.md) (1 credit · `GET /v1/threads/profile`) - [Spotify Artist API](https://socialtap.dev/apis/spotify/artist/index.md) (1 credit · `GET /v1/spotify/artist`) - [Amazon Shop API](https://socialtap.dev/apis/amazon/shop/index.md) (1 credit · `GET /v1/amazon/shop`) - [Apple Music Artist API](https://socialtap.dev/apis/applemusic/artist/index.md) (1 credit · `GET /v1/applemusic/artist`) - [Rumble Channel API](https://socialtap.dev/apis/rumble/profile/index.md) (1 credit · `GET /v1/rumble/profile`) - [X (Twitter) Profile API](https://socialtap.dev/apis/x/profile/index.md) (1 credit · `GET /v1/x/profile`) - [Bluesky Profile API](https://socialtap.dev/apis/bluesky/profile/index.md) (1 credit · `GET /v1/bluesky/profile`) - [Twitch Profile API](https://socialtap.dev/apis/twitch/profile/index.md) (1 credit · `GET /v1/twitch/profile`) - [LinkedIn Profile API](https://socialtap.dev/apis/linkedin/profile/index.md) (From 1 credit · `GET /v1/linkedin/profile`) - [Telegram Channel API](https://socialtap.dev/apis/telegram/channel/index.md) (1 credit · `GET /v1/telegram/channel`) - [Kwai Profile API](https://socialtap.dev/apis/kwai/profile/index.md) (1 credit · `GET /v1/kwai/profile`) - [Snapchat Profile API](https://socialtap.dev/apis/snapchat/profile/index.md) (1 credit · `GET /v1/snapchat/profile`) - [SoundCloud Artist API](https://socialtap.dev/apis/soundcloud/artist/index.md) (1 credit · `GET /v1/soundcloud/artist`) - [Truth Social Profile API](https://socialtap.dev/apis/truthsocial/profile/index.md) (1 credit · `GET /v1/truthsocial/profile`) - [Komi Page API](https://socialtap.dev/apis/komi/page/index.md) (1 credit · `GET /v1/komi/page`) - [Lnk.Bio Profile API](https://socialtap.dev/apis/linkbio/profile/index.md) (1 credit · `GET /v1/linkbio/profile`) - [Linkme Profile API](https://socialtap.dev/apis/linkme/profile/index.md) (1 credit · `GET /v1/linkme/profile`) - [Linktree Profile API](https://socialtap.dev/apis/linktree/profile/index.md) (1 credit · `GET /v1/linktree/profile`) - [Pillar Page API](https://socialtap.dev/apis/pillar/page/index.md) (1 credit · `GET /v1/pillar/page`) - [Facebook Ad Library Advertiser Search API](https://socialtap.dev/apis/facebook/search_advertisers/index.md) (1 credit / page · `GET /v1/facebook/search_advertisers`) - [Google Ads Transparency Center Advertiser API](https://socialtap.dev/apis/google/advertiser/index.md) (1 credit · `GET /v1/google/advertiser`) 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 Pins API](https://socialtap.dev/apis/pinterest/pins/index.md) (1 credit / page · `GET /v1/pinterest/pins`) - [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/profile/) · [Docs index for AI agents](https://socialtap.dev/llms.txt) · [All docs in one file](https://socialtap.dev/llms-full.txt)