# Pinterest Profile API (https://www.socialcrawl.dev/platforms/pinterest/profile) > Returns a Pinterest account's public profile by username or profile link: display name, bio, followers, following, pins (`author.posts_count`), boards (`author.ext.board_count`), website (`author.external_url`), profile picture and the date the account was created (`author.joined_at`). An unknown username answers 404 and is not charged. List the account's boards with GET /v1/pinterest/user/boards. When the first source cannot answer, a further source serves the profile; on those records following, boards, website and creation date are null and the picture is the small one. TL;DR: `GET /v1/pinterest/profile` costs 1 credit per call and returns SocialCrawl's unified JSON schema. Single x-api-key auth, 100 free credits on signup. ## Parameters | Parameter | Required | Description | | --- | --- | --- | | `handle` | no | Pinterest username, for example pinterest from https://www.pinterest.com/pinterest/. Letters, digits and underscores; a leading @ is ignored. | | `url` | no | A Pinterest profile or board link instead of handle. | ## Code example ```bash curl -G "https://www.socialcrawl.dev/v1/pinterest/profile" \ --data-urlencode "handle=pinterest" \ -H "x-api-key: sc_YOUR_API_KEY" ``` ## FAQ ### What does the Pinterest Profile API return? Returns a Pinterest account's public profile: name, bio, followers, following, pin and board counts, website, picture and the date it joined. The response uses the same JSON envelope as every SocialCrawl endpoint, with the data, credits_used and request_id fields. ### When should I use the Pinterest Profile endpoint? Use it to size up a Pinterest account from its username or link; user/boards lists the boards themselves. ### How much does the Pinterest Profile API cost? Each call costs 1 credit, so the 100 free credits every new account gets cover 100 calls. Credits for failed or empty calls are refunded automatically, and there is no subscription. ### What parameters does the Pinterest Profile API need? Identify the target with one of handle, url. It also accepts 2 optional parameters, all listed on this page. ### How do I call the Pinterest Profile API? Send a GET request to https://www.socialcrawl.dev/v1/pinterest/profile?handle=pinterest with your API key in the x-api-key header. An Authorization: Bearer header works too. See the full Pinterest API: https://www.socialcrawl.dev/platforms/pinterest ## Pricing - Standard endpoints: 1 credit per call - Advanced endpoints: 5 credits per call - Premium endpoints: 10 credits per call - 100 free credits on signup, no credit card required. Cached responses cost 0 credits. Credit packs never expire. - Full pricing: https://www.socialcrawl.dev/pricing ## Explore with AI Questions this API answers, phrased for an AI assistant: - What does the SocialCrawl Pinterest Profile API return? - How do I get Pinterest Profile data with the SocialCrawl API?