# Pinterest API: Search pins > Finds Pinterest pins for an idea in search order, with image, creator, board, saves and linked website. Limited to the first public search page. Unofficial. Not affiliated with or endorsed by Pinterest. - Page: https://fous.com/methods/pinterest.com/search-pins - Method: `pinterest.com/search_pins`, version 1 - Website: pinterest.com - Returns: title, description, image link, saves, pinner username, board name, website, website domain, pin link, pin id - Effect: read (it gets data and changes nothing) - Sign-in: none needed - Cost: 1 credit per completed run (1¢ with pay as you go); failed runs are free - Verified: Nov 2, 2026 ## Inputs | Field | Type | Required | In the run below | Description | |---|---|---|---|---| | `query` | string | yes | `"crochet amigurumi pattern"` | Idea to search for, for example small kitchen ideas. | | `max_results` | integer | no | `50` | Most pins to return from the first page, for example 25. Default 25. | ## Output From a run on Oct 31, 2026, shortened. Its input: ```json { "query": "crochet amigurumi pattern", "max_results": 50 } ``` Its output: ```json { "pins": [ { "saves": null, "title": "Floppy Bunny Amigurumi | Easy Crochet Bunny Pattern", "pin_id": "e1_AfqPShyeKOJnq0rCYucf0uJeuyD3upS_sfucFHvJPTQmJU1-Fw9tJg", "website": null, "pin_link": "https://www.pinterest.com/pin/e1_AfqPShyeKOJnq0rCYucf0uJeuyD3upS_sfucFHvJPTQmJU1-Fw9tJg/", "board_name": "Free Crochet Patterns & Ideas", "image_link": "https://i.pinimg.com/originals/c8/49/43/c84943b98b36678de52a2a9c78f9224c.png", "description": "Crochet an adorable floppy bunny amigurumi with this easy crochet bunny pattern. Perfect for makers who love cute crochet animals, bunny amigurumi patterns, beginner crochet projects, and soft crochet plushies. The long floppy ears and cuddly shape make this a sweet handmade project or gift idea. Cl…", "website_domain": null, "pinner_username": "yarnessa01" }, { "saves": null, "title": "Free Strawberry Dragon Beginner Crochet Pattern Amigurumi Fantasy", "pin_id": "e1_AfqPShxnbZT4pqJy5F3RcvJrTI7WdZV-0TLB71A-oxOmUZAEN6Yaww", "website": null, "pin_link": "https://www.pinterest.com/pin/e1_AfqPShxnbZT4pqJy5F3RcvJrTI7WdZV-0TLB71A-oxOmUZAEN6Yaww/", "board_name": "Crochet Ideas", "image_link": "https://i.pinimg.com/originals/c2/db/9a/c2db9a55fe77ff442b849145b0de86a3.png", "description": "Combine cute fruit aesthetics with fantasy! This Strawberry Dragon crochet guide covers every step from the strawberry-seeded body and snout to green leaf crown and dragon wings. Perfect project for plushie lovers and amigurumi creators. #StrawberryDragon #AmigurumiDragon #CrochetPlushie #FreeCroc…", "website_domain": null, "pinner_username": "crochettiideas" }, { "saves": null, "title": null, "pin_id": "e1_AfqPShzEzwfdhajWBWEbRgthWlfhYmVs5psiUtZa1713ZMzvex4", "website": null, "pin_link": "https://www.pinterest.com/pin/e1_AfqPShzEzwfdhajWBWEbRgthWlfhYmVs5psiUtZa1713ZMzvex4/", "board_name": "crochet/knitting", "image_link": "https://i.pinimg.com/originals/d2/06/f4/d206f417ae5a6b16cd9025182752cc1e.jpg", "description": null, "website_domain": null, "pinner_username": "linzyjm" } ] } ``` ## Run it From code, with a Fous API key in `FOUS_API_KEY`; the answer's `data` holds the output: ```bash curl https://api.fous.com/v1/runs \ -H "Authorization: Bearer $FOUS_API_KEY" \ -H "Content-Type: application/json" \ -d '{"method":"pinterest.com/search_pins","input":{"query":"crochet amigurumi pattern","max_results":50}}' ``` From an AI agent connected to the Fous MCP server: its `run` with the same method and input. To connect one, give it `set up https://fous.com/SKILL.md`. ## Ask your agent - Find me pins for boho bedroom decor ideas, about 20 of them, with the image and how many saves each has - Search Pinterest for 'easy weeknight vegetarian dinners' and give me the top 10 results with the linked recipe websites - I need inspiration for a small balcony garden — pull up the first 30 pins, including who pinned them and which board they're on - What are people saving for 'fall nail art 2024'? Show me up to 50 pins with their save counts and pin links - Look up Pinterest results for minimalist wedding invitations and list the source domains and creators for the first 15 pins ## Input schema ```json { "type": "object", "required": [ "query" ], "properties": { "query": { "type": "string", "minLength": 1, "description": "Idea to search for, for example small kitchen ideas." }, "max_results": { "type": "integer", "default": 25, "maximum": 50, "minimum": 1, "description": "Most pins to return from the first page, for example 25." } } } ``` ## Output schema ```json { "type": "object", "required": [ "pins" ], "properties": { "pins": { "type": "array", "items": { "type": "object", "required": [ "title", "description", "image_link", "saves", "pinner_username", "board_name", "website", "website_domain", "pin_link", "pin_id" ], "properties": { "saves": { "type": [ "integer", "null" ] }, "title": { "type": [ "string", "null" ] }, "pin_id": { "type": "string" }, "website": { "type": [ "string", "null" ] }, "pin_link": { "type": "string" }, "board_name": { "type": [ "string", "null" ] }, "image_link": { "type": [ "string", "null" ] }, "description": { "type": [ "string", "null" ] }, "website_domain": { "type": [ "string", "null" ] }, "pinner_username": { "type": [ "string", "null" ] } }, "additionalProperties": false } } }, "additionalProperties": false } ``` ## See more - [Pinterest API: Get profile](https://fous.com/methods/pinterest.com/get-profile.md): Gets a public Pinterest profile and its visible boards in profile order. Monthly views are null when Pinterest does not show them. - [PyPI API: Search packages](https://fous.com/methods/pypi.org/search-packages.md): Searches PyPI by keywords and returns matching packages in relevance order, each with its latest version and that version's release date. Returns up to 100 results. - [Pexels API: Search photos](https://fous.com/methods/pexels.com/search-photos.md): Search free stock photos on Pexels by subject, orientation, and page. Returns up to 80 photos in search order; Pexels may broaden searches with few exact matches. - [Wikimedia Commons API: Search free images](https://fous.com/methods/commons.wikimedia.org/search-free-images.md): Finds free-to-use Wikimedia Commons images for a topic in Commons relevance order. Each image comes with its links, creator and licence details. - [Bing API: Search the web](https://fous.com/methods/bing.com/search-web.md): Searches Bing and returns web results in the order shown, with snippets, answer-box text when available, and related searches. - [Unsplash API: Search photos](https://fous.com/methods/unsplash.com/search-photos.md): Finds Unsplash photos matching a search phrase, in search order, optionally by shape; excludes Unsplash+ photos unless included. Each result has image links, photographer, licence and photo page. - [Product Hunt API: Search products](https://fous.com/methods/producthunt.com/search-products.md): Finds Product Hunt products by name or by what they do, in Product Hunt search order, with tagline, review rating, review count, followers and topics. Ratings are null for products without reviews. - [Google API: Search Chrome extensions](https://fous.com/methods/chromewebstore.google.com/search-extensions.md): Finds Chrome Web Store extensions by keywords in store order, with each listing's developer, users, rating, rating count, short description and store link. Some listings omit developer, users or ratings. - [All Pinterest methods](https://fous.com/methods/pinterest.com.md)