{"id":"c3912169-1fb1-4a6f-a7aa-4505a0120758","slug":"pinterest-com-api","name":"pinterest.com API","description":"pinterest.com API","front_facing_description":"Search Pinterest for pins matching your query and instantly access detailed information about each result, including images, creator profiles, and board details. Find the newest and most relevant pins across all of Pinterest's content in one convenient interface.","source_url":"https://pinterest.com","is_authenticated":false,"canonical_scraper_id":"e3dd9006-958b-4837-a658-065d36611ff4","apis":[{"method":"GET","endpoint_name":"search_pins","description":"Full-text search over Pinterest pins. Returns pins matching the query with metadata including title, description, image, pinner, board, and creation date. Results are auto-iterated via bookmark-based pagination. Each pin includes its source domain and external link when available.","input_params":{"query":{"type":"string","required":true,"description":"Search query for Pinterest pins (e.g. 'home decor', 'cats', 'travel').","domain":{"kind":"open","example":"home decor","generator":{"type":"static","value":"home decor"}}},"bookmark":{"type":"string","required":false,"description":"Pagination bookmark from a previous response's next_bookmark field. Omit for first page.","domain":{"kind":"open","example":"","generator":{"type":"static","value":""}}}},"return_schema":{"type":"object","fields":{"pins":"array of pin objects with id, title, description, link, domain, created_at, image_url, dominant_color, pinner_username, pinner_full_name, board_name, board_url","result_count":"number of pins returned in this page","next_bookmark":"pagination bookmark for the next page, empty string when no more results"},"sample":{"data":{"pins":[{"id":"42713896465703314","link":"","title":"cat","domain":"Uploaded by user","board_url":"/g_honorato/memes-icons/","image_url":"https://i.pinimg.com/736x/fa/b5/dc/fab5dc1d3bb9ef9741e496c22a9786ec.jpg","board_name":"memes icons","created_at":"Sat, 04 Jul 2026 19:09:13 +0000","description":"#cute #cat #kitten #pfp #cutecat","dominant_color":"#996e85","pinner_username":"g_honorato","pinner_full_name":"Gabriela Honorato"}],"result_count":10,"next_bookmark":"Y2JVSG81V2sxcmNH..."},"status":"success"}},"initiates_session":false,"price":5,"verification":{"assertions":[{"path":"$.status","op":"equals","value":"success"},{"path":"$.data.pins","op":"array_min_len","value":1},{"path":"$.data.pins[*]","op":"field_present","value":"id"},{"path":"$.data.pins[*]","op":"field_present","value":"title"},{"path":"$.data.pins[*]","op":"field_present","value":"created_at"}],"empty_is_valid":false,"recipe_version":1}},{"method":"GET","endpoint_name":"get_pin","description":"Retrieve detailed information about a specific Pinterest pin by its numeric ID or full pin URL. Returns pin metadata including title, description, image, pinner/author details (username, full name, profile URL), board info, engagement counts (saves, comments, repins, shares), creation date, source link, and domain. One API call per pin.","input_params":{"pin":{"type":"string","required":true,"description":"Pinterest pin ID (numeric, e.g. '620441286183808599') or full pin URL (e.g. 'https://www.pinterest.com/pin/620441286183808599/').","domain":{"kind":"open","example":"620441286183808599","generator":{"type":"static","value":"620441286183808599"}}}},"return_schema":{"type":"object","fields":{"id":"pin ID string","link":"external source link URL if available","title":"pin title","domain":"source domain of the pin content","board_url":"full URL to the board","image_url":"URL to 736px wide pin image","board_name":"name of the board the pin is saved to","created_at":"creation date string","save_count":"number of saves/repins aggregated","description":"pin description text","repin_count":"number of repins","share_count":"number of shares","comment_count":"number of comments on the pin","dominant_color":"hex color code of dominant image color","pinner_username":"username of the pin author","pinner_full_name":"full display name of the pin author","pinner_profile_url":"full URL to the pinner's profile"},"sample":{"data":{"id":"620441286183808599","link":"","title":"","domain":"Uploaded by user","board_url":"https://www.pinterest.com/muazzezabdikdemir/ziyaret-edilecek-yerler/","image_url":"https://i.pinimg.com/736x/96/e3/24/96e324ebcf81fe72d071cc15d822d062.jpg","board_name":"Ziyaret edilecek yerler","created_at":"Wed, 22 Feb 2023 18:53:12 +0000","save_count":173,"description":"Hugo boss polos Excellent art Store article Matty lycra M to xxl 1.1.1.1","repin_count":10,"share_count":2,"comment_count":0,"dominant_color":"#786448","pinner_username":"muazzezabdikdemir","pinner_full_name":"Muazzez Demir","pinner_profile_url":"https://www.pinterest.com/muazzezabdikdemir/"},"status":"success"}},"initiates_session":false,"price":1,"verification":{"assertions":[{"path":"$.status","op":"equals","value":"success"},{"path":"$.data","op":"field_present","value":"id"},{"path":"$.data","op":"field_present","value":"pinner_username"},{"path":"$.data","op":"field_present","value":"save_count"}],"empty_is_valid":false,"recipe_version":1}}],"sample_inputs":{"get_pin":{"pin":"620441286183808599"},"search_pins":{"query":"home decor"}},"prefill_inputs":{"search_pins":{"query":"home decor","bookmark":""},"get_pin":{"pin":"620441286183808599"}},"last_verified_at":"2026-10-27T21:00:25.248409+00:00","endpoint_health":[{"endpoint_name":"search_pins","status":"healthy","last_checked_at":"2026-10-27T21:00:25.248409+00:00","last_verified_at":"2026-10-27T21:00:25.248409+00:00","recent_runs":[{"at":"2026-10-27T21:00:25.248409+00:00","status":"healthy"},{"at":"2026-10-20T20:00:53.089527+00:00","status":"healthy"},{"at":"2026-10-13T19:02:52.863194+00:00","status":"healthy"},{"at":"2026-10-06T18:04:25.204830+00:00","status":"healthy"},{"at":"2026-09-29T17:02:25.193866+00:00","status":"healthy"}]},{"endpoint_name":"get_pin","status":"healthy","last_checked_at":"2026-10-27T21:00:25.248409+00:00","last_verified_at":"2026-10-27T21:00:25.248409+00:00","recent_runs":[{"at":"2026-10-27T21:00:25.248409+00:00","status":"healthy"},{"at":"2026-10-20T20:00:53.089527+00:00","status":"healthy"},{"at":"2026-10-13T19:02:52.863194+00:00","status":"healthy"},{"at":"2026-10-06T18:04:25.204830+00:00","status":"healthy"},{"at":"2026-09-29T17:02:25.193866+00:00","status":"healthy"}]}],"sdk_usage_example":{"code":"\"\"\"Walkthrough: pinterest SDK — bounded, re-runnable; every call capped.\"\"\"\nfrom parse_apis.pinterest_com_api import Pinterest, InputFormatInvalid\n\nclient = Pinterest()\n\n# Search for pins with a topic query, cap total items.\nfor pin in client.pins.search(query=\"home decor\", limit=3):\n    print(pin.title, pin.created_at, pin.domain)\n\n# Drill-down: take one pin for detailed inspection via point lookup.\npin = client.pins.search(query=\"cats\", limit=1).first()\nif pin:\n    detail = client.pins.get(pin=pin.id)\n    print(detail.id, detail.title, detail.pinner_username)\n    print(\"saves:\", detail.save_count, \"comments:\", detail.comment_count)\n\n# Typed error: wrap a call that may reject malformed input.\ntry:\n    for p in client.pins.search(query=\"travel photography\", limit=2):\n        print(p.title, p.pinner_full_name)\nexcept InputFormatInvalid as e:\n    print(\"invalid input:\", e)\n\nprint(\"exercised: pins.search / pins.get\")\n","endpoints":["search_pins","get_pin"],"has_session":false,"shape":"parse_sdk","hover_map":[{"line":7,"col":4,"len":3,"label":"pin: Pin","kind":"variable"},{"line":11,"col":0,"len":3,"label":"pin: Pin","kind":"variable"},{"line":12,"col":3,"len":3,"label":"pin: Pin","kind":"variable"},{"line":4,"col":9,"len":9,"label":"Pinterest — API client","kind":"class"},{"line":7,"col":23,"len":6,"label":"search() → List[Pin]","kind":"method"},{"line":13,"col":4,"len":6,"label":"detail: Pin","kind":"variable"},{"line":19,"col":8,"len":1,"label":"p: Pin","kind":"variable"},{"line":21,"col":7,"len":18,"label":"InputFormatInvalid — error: A parameter has an invalid format or is missing","kind":"error"},{"line":8,"col":14,"len":5,"label":"title: str","kind":"field"},{"line":8,"col":25,"len":10,"label":"created_at: str","kind":"field"},{"line":8,"col":41,"len":6,"label":"domain: str","kind":"field"},{"line":13,"col":25,"len":3,"label":"get() → Pin","kind":"method"},{"line":14,"col":17,"len":2,"label":"id: str","kind":"field"},{"line":14,"col":28,"len":5,"label":"title: str","kind":"field"},{"line":14,"col":42,"len":15,"label":"pinner_username: str","kind":"field"},{"line":15,"col":27,"len":10,"label":"save_count: Optional[int]","kind":"field"},{"line":15,"col":59,"len":13,"label":"comment_count: Optional[int]","kind":"field"},{"line":19,"col":25,"len":6,"label":"search() → List[Pin]","kind":"method"},{"line":8,"col":10,"len":3,"label":"pin: Pin","kind":"variable"},{"line":8,"col":21,"len":3,"label":"pin: Pin","kind":"variable"},{"line":8,"col":37,"len":3,"label":"pin: Pin","kind":"variable"},{"line":11,"col":18,"len":6,"label":"search() → List[Pin]","kind":"method"},{"line":13,"col":37,"len":2,"label":"id: str","kind":"field"},{"line":14,"col":10,"len":6,"label":"detail: Pin","kind":"variable"},{"line":14,"col":21,"len":6,"label":"detail: Pin","kind":"variable"},{"line":14,"col":35,"len":6,"label":"detail: Pin","kind":"variable"},{"line":15,"col":20,"len":6,"label":"detail: Pin","kind":"variable"},{"line":15,"col":52,"len":6,"label":"detail: Pin","kind":"variable"},{"line":20,"col":16,"len":5,"label":"title: str","kind":"field"},{"line":20,"col":25,"len":16,"label":"pinner_full_name: str","kind":"field"},{"line":22,"col":28,"len":1,"label":"e: InputFormatInvalid","kind":"variable"},{"line":13,"col":33,"len":3,"label":"pin: Pin","kind":"variable"},{"line":20,"col":14,"len":1,"label":"p: Pin","kind":"variable"},{"line":20,"col":23,"len":1,"label":"p: Pin","kind":"variable"}]},"sdk_delivery_state":"available","summary":"Search Pinterest pins by query and retrieve newest posts with metadata including images, pinners, and boards.","updated_at":"2026-08-18T12:40:34.734754+00:00","user_variants":[],"latest_version":3,"user_status":null,"user_scraper_id":null,"contributes_to_marketplace":true,"pinned_version":null,"seo_content":{"faqs":[{"a":"Yes. Pinterest offers an official API at https://developers.pinterest.com, which provides endpoints for managing pins, boards, and ad campaigns. It requires OAuth 2.0 and is primarily oriented toward authenticated write operations and business analytics, with tighter access controls than this API.","q":"Does Pinterest have an official developer API?"},{"a":"`get_pin` returns `save_count`, which aggregates saves and repins. It does not currently return comment text or a list of individual users who saved a pin — only the aggregated count. You can fork this API on Parse and revise it to add a comments endpoint if that data is needed.","q":"What engagement data does `get_pin` return?"},{"a":"No. The API only returns data from publicly visible pins. Pins saved to secret boards do not appear in search results. There is no way to retrieve private content through this API, even by ID.","q":"Does `search_pins` return pins from private boards?"},{"a":"Not currently. The API covers full-text search via `search_pins` and direct pin lookup via `get_pin`. It does not expose board browsing or profile-level feeds. You can fork this API on Parse and revise it to add a board or profile endpoint.","q":"Is there a way to browse pins by board or by a specific pinner's profile?"},{"a":"Results are paginated using a bookmark cursor. Each response includes a `next_bookmark` string; pass it as the `bookmark` parameter in your next request to fetch the following page. When `next_bookmark` is an empty string, you have reached the last available page for that query.","q":"How does pagination work in `search_pins`?"}],"keywords":["Pinterest pins API","Pinterest search API","Pinterest pin metadata API","Pinterest image scraper API","get Pinterest pin details","Pinterest board data API","Pinterest save count API","Pinterest pinner profile API","search Pinterest by keyword API","Pinterest pagination API","Pinterest pin image URL","Pinterest dominant color API","Pinterest source domain data","Pinterest content discovery API"],"use_cases":["Monitor trending topics on Pinterest by searching keywords and sorting results by `created_at`.","Aggregate product inspiration boards by searching category terms and extracting `link` and `domain` fields to find source retailers.","Build a pinner analytics tool using `pinner_username` and `save_count` from `get_pin` responses.","Enrich a content database with Pinterest imagery by fetching `image_url` for matching pins via `search_pins`.","Track how specific content spreads on Pinterest by querying a brand name and logging `save_count` over time using `get_pin`.","Research dominant color palettes for a design project by collecting `dominant_color` values from `search_pins` results.","Identify top boards for a niche by extracting `board_name` and `board_url` fields across multiple searches."],"meta_title":"Pinterest API — Search Pins & Get Pin Details","generated_at":"2026-08-18T12:40:59.742454+00:00","lead_paragraph":"The Pinterest API provides 2 endpoints for retrieving pin data from Pinterest.com. Use `search_pins` to run full-text searches across Pinterest and get back paginated results with titles, images, pinner usernames, board names, source domains, and creation dates. Use `get_pin` to fetch a single pin by numeric ID or full URL, including engagement metrics like save counts and comment counts.","schema_version":2,"meta_description":"Search Pinterest pins by keyword and fetch detailed pin metadata: images, pinner profiles, board info, save counts, and more. 2 endpoints, JSON responses.","primary_category":"social_media","long_description_md":"## Endpoints\n\nThe `search_pins` endpoint accepts a `query` string and returns a page of matching pins. Each pin object includes `id`, `title`, `description`, `image_url`, `dominant_color`, `link`, `domain`, `created_at`, `pinner_username`, and board details. The `result_count` field tells you how many pins are on the current page, and `next_bookmark` holds the cursor for the next page — pass it back as the `bookmark` parameter to iterate through results. An empty `next_bookmark` indicates the last page.\n\n## Pin Detail\n\nThe `get_pin` endpoint accepts either a numeric pin ID (e.g. `620441286183808599`) or a full Pinterest URL. The response adds fields not present in search results: `save_count`, `board_url`, `board_name`, and `description` as a standalone field alongside the aggregated `save_count` for saves and repins. The `image_url` is normalized to a 736px-wide version. The `link` and `domain` fields identify the original source the pin points to, when one exists.\n\n## Data Coverage\n\nBoth endpoints return publicly visible pin data. The `search_pins` endpoint reflects the same index Pinterest exposes through its search interface, ordered by relevance and recency. Results include pins from any board or pinner that has not been made private. The `created_at` field is returned as a date string directly from Pinterest's pin metadata.","generated_with_model":"global.anthropic.claude-sonnet-4-6","secondary_categories":["ecommerce","entertainment"]},"primary_category":"social_media","secondary_categories":["ecommerce","entertainment"],"access_requirements":[]}