Platform availability
- 24h health
- Normal
Last 30 days
Available capabilities
Each Pinterest action, what it does, its price and its health over the last 24 hours. Open an action for its parameters, response fields and code samples.
| Capability | What it does | Per 1,000 | 24-hour health |
|---|---|---|---|
Searchsearch | Search Pinterest Pins by keyword, across all Pins or video Pins only, with image, source domain, dominant color, reactions, board and pinner details. | $1.39 per 1,000 requests | Normal |
Profilesprofile | Look up a Pinterest account by handle, with or without the @, for its bio, website, verification, privacy flag and follower, Pin, board and video counts. | $1.39 per 1,000 requests | Normal |
Posts by useruser_posts | Pull the Pins a Pinterest account has published, telling images, videos and outbound links apart, with repin, reaction and comment counts and the board each one sits on. | $1.39 per 1,000 requests | Normal |
Pin detailspin | Fetch one Pinterest Pin from a /pin/ link with its numeric ID, returning media, outbound link and domain, alt text, dominant color, board and engagement counts. | $1.39 per 1,000 requests | Normal |
Boardsboards | List the boards a Pinterest account owns, with description, cover image, Pin and section counts, followers, privacy setting and a collaborative flag. | $1.39 per 1,000 requests | Normal |
Pins on a boardboard_pins | Go through the Pins saved on one Pinterest board, keyed by board_id such as pinterest/official-news, with media, outbound link, author and engagement for each. | $1.39 per 1,000 requests | Normal |
Board detailsboard_detail | Check a Pinterest board's owner, description, cover, privacy, collaborative flag and Pin, section and follower counts from its board url. | $1.39 per 1,000 requests | Normal |
Open a capability for its parameters, response fields, code samples and trial.
What does each Pinterest action accept?
Each answer below pairs one callable action with its real inputs. Parameter meanings and allowed values are action-specific; a familiar name does not carry the same meaning across every platform.
Official sources are linked only to clarify the platform term beside them. They do not imply platform authorization or endorsement, and they do not add official-site features to the EveryInfra API contract.
| Action | Required | Optional | Delivery | Limit | Per 1,000 | Response fields |
|---|---|---|---|---|---|---|
searchSearch Search Pinterest Pins by keyword, across all Pins or video Pins only, with image, source domain, dominant color, reactions, board and pinner details. Boards and creators are not returned, and a Pin grants no rights to its image or vouches for the linked site. | keyword | content_type | Sync delivery | Catalog values: defaultLimit=20, maxLimit=50. A limit can control pages or per-parent expansion for some actions, so it is not always a final row count. | $1.39 per 1,000 requests | id · url · title · text · image_url · reaction_count · source_domain · dominant_color · posted_at · author_username · author_name · author_follower_count · board_name · platform |
profileProfiles Look up a Pinterest account by handle, with or without the @, for its bio, website, verification, privacy flag and follower, Pin, board and video counts. Profile URLs are not accepted, and a listed website does not prove domain ownership or reveal secret boards. | username | — | Sync delivery | — | $1.39 per 1,000 requests | user_id · username · name · bio · avatar_url · follower_count · following_count · pin_count · board_count · video_count · website · is_verified · is_private · created_at · platform |
user_postsPosts by user Pull the Pins a Pinterest account has published, telling images, videos and outbound links apart, with repin, reaction and comment counts and the board each one sits on. Coverage of every board and of older Pins is not guaranteed. | username | — | Sync delivery | Catalog values: defaultLimit=20, maxLimit=50. A limit can control pages or per-parent expansion for some actions, so it is not always a final row count. | $1.39 per 1,000 requests | id · url · title · text · image_url · video_url · media_type · external_link · source_domain · reaction_count · repin_count · comment_count · share_count · dominant_color · alt_text · posted_at · author_username · author_name · board_name · price · platform |
pinPin details Fetch one Pinterest Pin from a /pin/ link with its numeric ID, returning media, outbound link and domain, alt text, dominant color, board and engagement counts. Board links are rejected here, and the outbound site is neither crawled nor licensed. | url | — | Sync delivery | — | $1.39 per 1,000 requests | id · url · title · text · image_url · video_url · media_type · external_link · source_domain · reaction_count · repin_count · comment_count · share_count · dominant_color · alt_text · posted_at · author_username · author_name · board_name · price · platform |
boardsBoards List the boards a Pinterest account owns, with description, cover image, Pin and section counts, followers, privacy setting and a collaborative flag. A collaborative board does not reveal all of its members or any private content. | username | — | Sync delivery | Catalog values: defaultLimit=20, maxLimit=50. A limit can control pages or per-parent expansion for some actions, so it is not always a final row count. | $1.39 per 1,000 requests | id · name · url · description · pin_count · section_count · follower_count · cover_image_url · is_collaborative · privacy · owner_username · owner_name · created_at · platform |
board_pinsPins on a board Go through the Pins saved on one Pinterest board, keyed by | board_id | — | Sync delivery | Catalog values: defaultLimit=20, maxLimit=50. A limit can control pages or per-parent expansion for some actions, so it is not always a final row count. | $1.39 per 1,000 requests | id · url · title · text · image_url · video_url · media_type · external_link · source_domain · reaction_count · repin_count · comment_count · share_count · dominant_color · alt_text · posted_at · author_username · author_name · board_name · price · platform |
board_detailBoard details Check a Pinterest board's owner, description, cover, privacy, collaborative flag and Pin, section and follower counts from its board | url | — | Sync delivery | — | $1.39 per 1,000 requests | id · name · url · description · pin_count · section_count · follower_count · cover_image_url · is_collaborative · privacy · owner_username · owner_name · created_at · platform |
What do the Pinterest search parameters mean?
Search Pinterest Pins by keyword, across all Pins or video Pins only, with image, source domain, dominant color, reactions, board and pinner details. Boards and creators are not returned, and a Pin grants no rights to its image or vouches for the linked site.
Full API reference: parameters, code samples, response example and health →keywordRequired- Specifies search terms or inspiration topics for the search action. Returned result entity structures depend on the selected content_type.
content_typeOptional- Filters search results by pin type: all_pins_visual_posts for all pins (not only image pins) or videos_video_pins for video pins only. Search returns pins only, not boards or creators.Allowed values:
all_pins_visual_postsvideos_video_pinsPinterest: Image Pins, Video Pins, and Product Pins — Pinterest defines Pins as visual bookmarks and distinguishes formats such as image, video, and product. This is used to explain content objects and does not mean search returns all official objects or media fields; search type conflicts on this page remain subject to the limitations above. · Checked
What do the Pinterest profile parameters mean?
Look up a Pinterest account by handle, with or without the @, for its bio, website, verification, privacy flag and follower, Pin, board and video counts. Profile URLs are not accepted, and a listed website does not prove domain ownership or reveal secret boards.
Full API reference: parameters, code samples, response example and health →usernameRequired- Specifies the Pinterest user handle for the profile, user_posts, and boards actions, with or without a leading @. Full profile web URLs are not accepted.
What do the Pinterest user_posts parameters mean?
Pull the Pins a Pinterest account has published, telling images, videos and outbound links apart, with repin, reaction and comment counts and the board each one sits on. Coverage of every board and of older Pins is not guaranteed.
Full API reference: parameters, code samples, response example and health →usernameRequired- Specifies the Pinterest user handle for the profile, user_posts, and boards actions, with or without a leading @. Full profile web URLs are not accepted.Pinterest: Saved Pins Are Not Guaranteed to Be Account-Original Content — Official documentation explains that image Pins can be created by uploading images or saving offsite images, where offsite saves retain links to the original site. Account-associated Pins cannot be directly equated with original works, and source verification does not replace content usage permissions. · Checked
What do the Pinterest pin parameters mean?
Fetch one Pinterest Pin from a /pin/ link with its numeric ID, returning media, outbound link and domain, alt text, dominant color, board and engagement counts. Board links are rejected here, and the outbound site is neither crawled nor licensed.
Full API reference: parameters, code samples, response example and health →urlRequired- Specifies the target URL for Pinterest requests. The pin action requires a pin URL containing /pin/NUMERIC_ID/, whereas board_detail requires a board link in the format /username/boardname/ (or its relative path). Board URLs cannot be used in place of pin URLs.Pinterest: Retailer Links on Product Pins — Official documentation states that product Pins can direct users to retailer websites, and certain rich Pins sync product details. This page returns only actually retrieved Pin fields and does not promise real-time inventory, ordering capabilities, or transaction data. · Checked
What do the Pinterest boards parameters mean?
List the boards a Pinterest account owns, with description, cover image, Pin and section counts, followers, privacy setting and a collaborative flag. A collaborative board does not reveal all of its members or any private content.
Full API reference: parameters, code samples, response example and health →usernameRequired- Specifies the Pinterest user handle for the profile, user_posts, and boards actions, with or without a leading @. Full profile web URLs are not accepted.Pinterest: Hierarchy of Boards and Board Sections — Pinterest uses board sections to organize Pins within a board. Therefore, `section_count` should not be treated as a board count; referencing section creation tutorials does not imply this endpoint can create, move, or edit content. · Checked
What do the Pinterest board_pins parameters mean?
Go through the Pins saved on one Pinterest board, keyed by board_id such as pinterest/official-news, with media, outbound link, author and engagement for each. Private sections are excluded, and the whole board is not guaranteed.
board_idRequired- Board identifier for board_pins: the username/board-name part of the board URL after pinterest.com/, for example pinterest/official-news. Each board in boards results has a url; drop the domain to get this value.Pinterest: Organizing Pins by Board Without Confusing Sections — Official documentation states that Pins can be placed into sections within a board. `board_id` here still targets only the board; official tutorials do not provide ID conversion capabilities for this endpoint, nor do they imply that section query parameters are available. · Checked
What do the Pinterest board_detail parameters mean?
Check a Pinterest board's owner, description, cover, privacy, collaborative flag and Pin, section and follower counts from its board url. The Pins themselves are not included; they come from board_pins.
urlRequired- Specifies the target URL for Pinterest requests. The pin action requires a pin URL containing /pin/NUMERIC_ID/, whereas board_detail requires a board link in the format /username/boardname/ (or its relative path). Board URLs cannot be used in place of pin URLs.Pinterest: Secret Board Visibility Rules — Official documentation specifies that secret boards are visible only to the owner and invited collaborators. Knowing a board link or ID does not constitute access permission, and this page does not provide capabilities to bypass secret settings. · Checked
How to use the Pinterest API
- 01Read the public catalog and choose a platform action.
- 02Send the platform, action, and required parameters to POST /api/v1/social.
- 03Handle a synchronous result, or poll the returned job ID when the action runs asynchronously.
- 04Store the structured response fields needed by your application.
curl -X POST https://api.everyinfra.com/api/v1/social \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"platform":"pinterest","action":"search","params":{"keyword":"<keyword>"}}'
Pinterest API questions
What can I retrieve with the Pinterest API?
Set platform to pinterest. The current catalog lists search, profiles, posts by user, Pin details, boards, and more. These action names identify different Pinterest objects or views; they are not interchangeable search modes.
Which input starts a Pinterest `search` request?
Specifies search terms or inspiration topics for the search action. Returned result entity structures depend on the selected content_type. Send it as keyword inside params.
Which fields can Pinterest `search` return?
Its declared schema includes title, text, image_url, and reaction_count. A declared field can still be absent from an individual record, and every other action has its own field list.
Does every Pinterest action return immediately?
Actions labeled asynchronous return a job ID you poll. Every other action can also run asynchronously: add "mode": "async" to the request body to receive a job ID immediately, useful for slow tasks or large limits. The current catalog contains sync delivery.