EveryData platform API
Pinterest API
This Pinterest reference organizes Pinterest Pins, profiles, account Pins, boards, board details, and Pins on a board into 7 concrete operations—`search`, `profile`, `user_posts` among them—so shared parameter names do not blur object types.
Search public results with Pinterest `search` using `keyword`, or fetch detailed account profiles with `profile` using `username`. All actions maintain strict scope boundaries.
- Endpoint
- POST /api/v1/social
- Capabilities
- 7
- Per 1,000
- $1.389
Available capabilities
Compare the Pinterest actions by required input, returned data, and price. Use the action identifier exactly as shown in your request.
| Action | Required | Optional | Delivery | Limit | Per 1,000 | Response fields |
|---|---|---|---|---|---|---|
searchSearch Search public results on Pinterest. Accepts these parameters: | 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 Retrieve public profile details from Pinterest. Accepts these parameters: | 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 Retrieve public posts from Pinterest. Accepts these parameters: | 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 Use the | 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 Use the | 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 Use the | 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 Retrieve board details from Pinterest. Accepts these parameters: | 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 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.
What do the Pinterest search parameters mean?
Search public results on Pinterest. Accepts these parameters: keyword and content_type. Returns these fields: posted_at, source_domain, board_name, and dominant_color.
keywordRequired- Specifies search terms or inspiration topics for the search action. Returned result entity structures depend on the selected content_type.
content_typeOptional- Filters result object types for the search action. Allowed values are all_pins_visual_posts (image/text pins), videos_video_pins (video pins), boards_pin_collections (boards), and profiles_creator_pages (creator pages).Allowed values:
all_pins_visual_postsboards_pin_collectionsprofiles_creator_pagesvideos_video_pinsPinterest: Image Pins, Video Pins, and Product PinsPinterest 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?
Retrieve public profile details from Pinterest. Accepts these parameters: username. Returns these fields: name, user_id, pin_count, and avatar_url.
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?
Retrieve public posts from Pinterest. Accepts these parameters: username. Returns these fields: media_type, alt_text, repin_count, and source_domain.
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 ContentOfficial 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?
Use the pin action on Pinterest. Accepts these parameters: url. Returns these fields: title, author_name, alt_text, and image_url.
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 PinsOfficial 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?
Use the boards action on Pinterest. Accepts these parameters: username. Returns these fields: name, description, cover_image_url, and created_at.
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 SectionsPinterest 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?
Use the board_pins action on Pinterest. Accepts these parameters: board_id. Returns these fields: alt_text, media_type, external_link, and repin_count.
board_idRequired- Specifies the numeric board ID for the board_pins action, typically obtained from boards response payloads. It does not accept board names or URLs.Pinterest: Organizing Pins by Board Without Confusing SectionsOfficial 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?
Retrieve board details from Pinterest. Accepts these parameters: url. Returns these fields: is_collaborative, pin_count, follower_count, and section_count.
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 RulesOfficial 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 selected action is asynchronous.
- 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 source record, and every other action has its own field list.
Does every Pinterest action return immediately?
No assumption is needed: this page labels each action's delivery mode. The current catalog contains sync delivery; poll a returned job ID only for an action labeled asynchronous.