Visual trend and inspiration research
Use Pinterest endpoints to turn visual trend and inspiration research into repeatable API requests with documented inputs and JSON responses.
Turn Pinterest's public pins, boards, and profiles into structured JSON — keyword pin search, a pin's full detail, a user's boards and pins, a specific board's detail, and the "Ideas" category taxonomy with per-category feeds, all as normalized JSON. Credential-free.
Search Pinterest pins and get pin detail, boards, user profiles, and the Ideas category taxonomy as structured JSON.
Endpoint families
6
Documented params
16
Examples
8
Live catalog snapshot
Active endpoints
8
Methods
GET
Required params
16
Schema refs
8
{
"platform": "Pinterest",
"endpoint": "pinterest-search",
"method": "GET",
"path": "/pinterest/search",
"auth": "apiKey"
}Use cases
Search Pinterest pins and get pin detail, boards, user profiles, and the Ideas category taxonomy as structured JSON.
Use Pinterest endpoints to turn visual trend and inspiration research into repeatable API requests with documented inputs and JSON responses.
Use Pinterest endpoints to turn creator and board monitoring into repeatable API requests with documented inputs and JSON responses.
Use Pinterest endpoints to turn content and category discovery into repeatable API requests with documented inputs and JSON responses.
Managed execution
Every figure below is read from the live Pinterest endpoint catalog — 8 endpoints, 16 documented request parameters, and 8 published response schemas — the same catalog Docs and Playground run against.
8 documented Pinterest endpoints, grouped into 6 request families — User, Board and Categories, plus 3 more.
16 request parameters are documented across those Pinterest endpoints, 16 of them required — the full input contract is public before you write any integration code.
8 of the 8 Pinterest endpoints ship a recorded example response, and 8 carry a documented response schema — you can code against the real JSON before the first request.
Pinterest endpoints document their error responses (400, 404, 500 and 503) alongside the success schema, so a block, a rate limit, or a missing record comes back as a typed error rather than silently empty data.
8 hosted MCP tools back the Pinterest endpoints, so an agent can call the same routes with the same parameters and the same JSON contract, with no custom glue.
Coverage map
These cards are generated from the active endpoint catalog, so the landing page reflects the same API surface used by Docs and Playground.
/pinterest/user/{username}
/pinterest/board/{username}/{slug}
/pinterest/categories
/pinterest/ideas/{id}
/pinterest/pin/{id}
/pinterest/search
Endpoint catalog
/pinterest/searchReturns public Pinterest pins matching a text query: title, description, image, board, and pinner for each result. Public data sourced from Pinterest's own web search.
Response notes
- `image_url` is the largest reasonably-sized image Pinterest returned for the pin (preferring `736x`, falling back through `474x`/`orig`/`236x`/`170x`). - `title` can be empty — many pins carry only a description, not a separate title. - `domain`/`link` point at the pin's off-Pinterest source when the pin was saved from a website; pins uploaded directly by a user instead carry `"domain": "Uploaded by user"` with no `link`. - A missing `query` returns `400` before any upstream request is made. Example response: ```json { "code": 200, "msg": "OK", "data": { "query": "minimalist living room", "pins": [ { "id": "21673641953485811", "url": "https://www.pinterest.com/pin/21673641953485811/", "title": "Minimalist Luxury Living Spaces That Look Clean But Still Cozy", "description": "Minimalist Luxury Living Spaces can feel cozy when the room uses texture, lighting, and practical furniture instead of extra clutter.", "image_url": "https://i.pinimg.com/736x/da/b7/2a/dab72a3f9f2b9f18274752facb0349ef.jpg", "dominant_color": "#957653", "domain": "impactdriverdrill.com", "link": "https://impactdriverdrill.com/minimalist-luxury-living-spaces/", "board_name": "Løkken hus", "pinner_username": "annlizeth9550" } ] } } ```
MCP tool pinterest_search
/pinterest/pin/{id}Returns a single Pinterest pin's full detail: title, description, image, board, pinner, comment count, save count, and creation time. Public data sourced from Pinterest's own pin pages.
Response notes
- `repin_count` is Pinterest's own save count for the pin; `comment_count` reflects public comments only. - An unrecognized `id` returns `404`. - A missing `id` returns `400` before any upstream request is made. Example response: ```json { "code": 200, "msg": "OK", "data": { "id": "52846995624279072", "url": "https://www.pinterest.com/pin/52846995624279072/", "title": "Milk Punch Recipe", "image_url": "https://i.pinimg.com/736x/de/08/76/de08769d89808e1373c95fdb53c1f324.jpg", "dominant_color": "#6a2f18", "domain": "Uploaded by user", "board_name": "EL CAFECITO", "pinner_username": "patrontequila", "comment_count": 0, "repin_count": 1, "created_at": "Fri, 26 Jun 2026 18:37:28 +0000" } } ```
MCP tool pinterest_pin
/pinterest/board/{username}/{slug}Returns a Pinterest board's metadata (name, description, cover image, pin/follower counts, owner) plus a page of pins from that board. Public data sourced from Pinterest's own board pages.
Response notes
- An unrecognized `username`/`slug` pair returns `404`. - A missing `username` or `slug` returns `400` before any upstream request is made. Example response: ```json { "code": 200, "msg": "OK", "data": { "id": "52847064316842646", "url": "/patrontequila/el-cafecito/", "name": "EL CAFECITO", "cover_image_url": "https://i.pinimg.com/200x150/4b/92/d4/4b92d41f01669ea16371351e138a8f12.jpg", "pin_count": 6, "follower_count": 10372, "privacy": "public", "owner_username": "patrontequila", "pins": [ { "id": "52846995624279072", "url": "https://www.pinterest.com/pin/52846995624279072/", "title": "Milk Punch Recipe", "image_url": "https://i.pinimg.com/736x/de/08/76/de08769d89808e1373c95fdb53c1f324.jpg", "dominant_color": "#6a2f18", "domain": "Uploaded by user", "board_name": "EL CAFECITO", "pinner_username": "patrontequila" } ] } } ```
MCP tool pinterest_board
/pinterest/user/{username}Returns a Pinterest user's public profile: display name, bio, website, avatar, and follower/following/pin/board counts. Public data sourced from Pinterest's own profile pages.
Response notes
- An unrecognized `username` returns `404`. - A missing `username` returns `400` before any upstream request is made. Example response: ```json { "code": 200, "msg": "OK", "data": { "username": "patrontequila", "full_name": "Patrón Tequila", "about": "Official Instagram for Patrón Tequila. Find cocktail recipes, entertaining ideas, and more.", "website_url": "http://patrontequila.com", "follower_count": 11311, "following_count": 61, "pin_count": 372, "board_count": 23, "avatar_url": "https://i.pinimg.com/140x140_RS/f4/11/b3/f411b3d14f20e013fbf6433a6947524f.jpg" } } ```
MCP tool pinterest_user
/pinterest/user/{username}/boardsReturns a page of a Pinterest user's own boards: name, description, cover image, and pin/follower counts for each. Public data sourced from Pinterest's own profile pages.
Response notes
- `owner_username` on each board always matches the requested `username`. - Each board's `url` is usable directly as the `username`/`slug` path parameters to [`/pinterest/board/{username}/{slug}`](pinterest-board.md). - A missing `username` returns `400` before any upstream request is made. Example response: ```json { "code": 200, "msg": "OK", "data": { "username": "patrontequila", "boards": [ { "id": "52847064316842828", "url": "/patrontequila/summer-cocktails/", "name": "Summer Cocktails", "cover_image_url": "https://i.pinimg.com/200x150/d0/8f/99/d08f99da806e4096a7dc9355d7fbd706.jpg", "pin_count": 2, "follower_count": 10372, "privacy": "public", "owner_username": "patrontequila" } ] } } ```
MCP tool pinterest_user_boards
/pinterest/user/{username}/pinsReturns a page of a Pinterest user's own pins: title, description, image, board, and pinner for each. Public data sourced from Pinterest's own profile pages.
Response notes
- `pinner_username` on each pin always matches the requested `username`. - A missing `username` returns `400` before any upstream request is made. Example response: ```json { "code": 200, "msg": "OK", "data": { "username": "patrontequila", "pins": [ { "id": "52846995624312550", "url": "https://www.pinterest.com/pin/52846995624312550/", "title": "Summer freshness, stirred. Enjoy a PATRÓN® Strawberry Margarita.", "description": "Discover a fresh flavorful sip for the hot weather. Find recipe here.", "image_url": "https://i.pinimg.com/736x/ee/06/7d/ee067d96fc479b935075a9eefb309c87.jpg", "dominant_color": "#ffffff", "domain": "patrontequila.com", "link": "https://www.patrontequila.com/cocktails/patron-silver/strawberry-margarita.html", "board_name": "Summer Cocktails", "pinner_username": "patrontequila" } ] } } ```
MCP tool pinterest_user_pins
/pinterest/categoriesReturns Pinterest's top-level "Ideas" category taxonomy (e.g. "Animals", "Home Decor", "Food And Drink"). Each entry's id is usable directly with GET /pinterest/ideas/{id}. Public data sourced from Pinterest's own ideas.pinterest.com-style category hub.
Response notes
- Each entry's `id` is the value to pass as the `id` path parameter to [`/pinterest/ideas/{id}`](pinterest-idea.md). - This is Pinterest's full top-level list — currently 10 categories. It changes rarely; results are fetched live on every call, not cached client-side. Example response: ```json { "code": 200, "msg": "OK", "data": { "categories": [ { "id": "925056443165", "slug": "animals", "name": "Animals" }, { "id": "961238559656", "slug": "art", "name": "Art" }, { "id": "935541271955", "slug": "beauty", "name": "Beauty" }, { "id": "902065567321", "slug": "design", "name": "Design" }, { "id": "934876475639", "slug": "diy-and-crafts", "name": "Diy And Crafts" }, { "id": "918530398158", "slug": "food-and-drink", "name": "Food And Drink" }, { "id": "935249274030", "slug": "home-decor", "name": "Home Decor" }, { "id": "924581335376", "slug": "mens-fashion", "name": "Mens Fashion" }, { "id": "948192800438", "slug": "quotes", "name": "Quotes" }, { "id": "922203297757", "slug": "tattoos", "name": "Tattoos" } ] } } ```
MCP tool pinterest_categories
/pinterest/ideas/{id}Returns one "Ideas" category's metadata (name, description, follower count) plus a page of pins from that category's feed. Public data sourced from Pinterest's own ideas category pages.
Response notes
- `follower_count` reflects Pinterest's own follower count for the category as a whole, not the requester. - An unrecognized `id` returns `404`. - A missing `id` returns `400` before any upstream request is made. Example response: ```json { "code": 200, "msg": "OK", "data": { "id": "925056443165", "name": "Animals", "description": "Animals are the best. Boost your mood with funny cat memes, or learn everything you need to know about caring for the family pet.", "follower_count": 138678383, "pins": [ { "id": "97531148175959884", "url": "https://www.pinterest.com/pin/97531148175959884/", "title": "world otter day", "description": "otters", "image_url": "https://i.pinimg.com/474x/11/1a/26/111a261d48f2ddb20e427ccc1692665b.jpg", "dominant_color": "#888b7e", "domain": "Uploaded by user", "board_name": "animals + insects", "pinner_username": "bellamwelsh" } ] } } ```
MCP tool pinterest_idea
Related APIs
Social & Creator Platforms
Build creator intelligence, video research, transcript, and audience-comment workflows without maintaining YouTube scrapers.
Social & Creator Platforms
Turn Twitch's public channel, stream, clip, and team data into structured JSON — live status and viewer counts, top games, clips, VODs, and team rosters — as normalized JSON. Credential-free.
Social & Creator Platforms
Track creator, content, hashtag, music, trend, and public ad creative signals from TikTok with production-ready API routes.
Company coverage
Pinterest, Inc. · PINS
Pinterest is operated by Pinterest, Inc. (PINS). Crawlora's SEC endpoints take the same company's CIK, so filings, financials, insider transactions and 13F holdings come from the same API key as the Pinterest endpoints above.
SEC filings & financials API →How to scrape Pinterest
Crawlora's Pinterest endpoints return pin search, pin detail, boards, user profiles, and category feeds as normalized JSON with one API key — no Pinterest account required.
Send a keyword to /pinterest/search for normalized pin results.
Pass a pin id to /pinterest/pin/{id}, or a username and board slug to /pinterest/board/{username}/{slug}.
Pass a username to /pinterest/user/{username} for their profile, or add /boards or /pins for their boards or own pins.
Use /pinterest/categories for the full list and /pinterest/ideas/{id} for a category's detail feed.
FAQ
Send a keyword to Crawlora's /pinterest/search endpoint and get normalized pin results as structured JSON — no Pinterest account required.
Yes — /pinterest/user/{username}/boards and /pinterest/user/{username}/pins return a user's boards and their own pins as structured JSON.
No Pinterest login or auth token is required from the caller — only your Crawlora API key.
Yes, but it's not self-serve. Pinterest's official API v5 requires a developer app, a Trial-access review (about one to two business days), and then a separate Standard/production-access application — including a video demo — that takes one to four weeks of manual review before you can call real endpoints outside the trial's public-hidden pins. Crawlora's Pinterest endpoints return pin search, pin detail, boards, and profiles as structured JSON with a single API key, no review process or waiting period.