# Pinterest Search API

Find public pins by keyword.

Give your agent a topic. ScrapeCreators returns pin links, available descriptions and image metadata for $0.02 per search page.

One page of public pin results. Subjects and descriptions vary by search. Image metadata identifies reference material. Usage rights depend on the source.

Provider in the worked example: ScrapeCreators.

Price shown for this route: 2¢ per search page.



## What the Pinterest Search API returns

### Search public pins

Send one keyword or phrase. Read pin links, creation dates and image metadata. Descriptions can be blank.

Price: $0.02 per search page.


## A real example

Tested on 2026-11-20 through ScrapeCreators.

ScrapeCreators returned 16 pin links, 14 nonblank descriptions and a cursor. Every record included image metadata.

Your agent asked: Search Pinterest for “small home office”. Return the public pin links and available descriptions, and report whether there is a next page.

Returned in this test:

- Search query: small home office
- Pins: 16 links · 14 with descriptions
- Image metadata: Present on all 16
- Next page: Cursor present
- First pin: [Home office with a desk, rug and wall shelves](https://www.pinterest.com/pin/873909502720959407)

Charged in this test: $0.02.

One page of public pin results. Subjects and descriptions vary by search. Image metadata identifies reference material. Usage rights depend on the source.




## Try the API request

Use your TaskFuel API key as TASKFUEL_API_KEY in your terminal or server. Keep it out of browser code.

### 1. Check the price

This request checks the price without paying. The test searched for small home office with trim=true, which requests a shorter response.

```sh
curl --fail-with-body https://app.taskfuel.ai/v1/call \
  -H "Authorization: Bearer $TASKFUEL_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-binary @- <<'TASKFUEL_REQUEST'
{
  "url": "https://mpp.orthogonal.com/scrapecreators/v1/pinterest/search?query=small%20home%20office&trim=true",
  "method": "GET",
  "dryRun": true
}
TASKFUEL_REQUEST
```

### 2. Run the request

Review amount_usd in the quote. To pay and run, change dryRun to false and add maxAmountUsd with that approved amount inside the same JSON object. Keep the inputs unchanged; this limit applies to one call.

### 3. Read the result

Read pins[].url, description, created_at and images. The sample included cursor at the top level.

[ScrapeCreators Pinterest Search reference](https://docs.scrapecreators.com/v1/pinterest/search/)

[Setup and API reference](https://taskfuel.ai/docs/) · [Job polling and timeout recovery](https://app.taskfuel.ai/using.md)


## Connect your agent

Read the [setup guide](https://taskfuel.ai/docs/setup/) and choose the connection your agent supports.

Use one TaskFuel account and prepaid balance. Inspect the provider and request quote before a paid call, then review the returned response and recorded charge.



## When to use it

### Collect references for a design brief.

Your agent can gather pin links and use the available descriptions to group references around the brief.

### Save links to revisit with your team.

Pin URLs identify individual references even when their descriptions are blank.




## Questions

### Is this Pinterest’s official API?

The worked search uses ScrapeCreators to find public pins through TaskFuel. Pinterest has a separate developer API for integrations.

### What happens if a pin description is blank?

The tested query returned two pins with blank descriptions. Both still had a pin link and image metadata.

### Does Pinterest Search API return every matching pin?

The example reads one result page. The response included a cursor for continuation, and further pages have their own price.

### What did the Pinterest Search API example cost?

The request cost $0.02 on 20 November 2026. Your agent shows the price for your own request before it pays.

### Do I need a ScrapeCreators account?

Your agent uses your TaskFuel connection and pays from your TaskFuel balance.

## Related tool guides

- [Look up a public Instagram profile](https://taskfuel.ai/tools/instagram-mcp/)
- [Read TikTok profile data through MCP](https://taskfuel.ai/tools/tiktok-mcp/)


## Reference

- [Read this guide on the website](https://taskfuel.ai/tools/pinterest-search-api/).
- [Browse providers and capabilities](https://taskfuel.ai/catalog/).
- [Pricing](https://taskfuel.ai/pricing/).
- [Agent instructions](https://taskfuel.ai/llms.txt).
