> ## Documentation Index
> Fetch the complete documentation index at: https://aisa.one/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# search
> Keyword search across Pinterest, with a trim switch that actually works.
Returns `pins` plus a `cursor` to page. Each pin carries `id`, `url`, `title`, `description`, `grid_title`, `created_at`, `images` in five sizes (`170x`, `236x`, `474x`, `736x`, `orig`), `link`, `domain`, `board` and `pinner`.
Measured at about 110 KB for 17 pins. **`trim=true` cuts that to 28 KB**, keeping six fields per pin — `id`, `url`, `description`, `created_at`, `images`, `pinner` — and dropping `title`, `link`, `board` and `domain`. Skip trim only when you need those four.
The `board.url` on each result feeds [`get_pinterest_board`](/docs/api-reference/pinterest/get_pinterest-board); for one pin's engagement counts use [`get_pinterest_pin`](/docs/api-reference/pinterest/get_pinterest-pin).
## Example
```bash REST theme={null}
curl "https://api.aisa.one/apis/v1/pinterest/search?query=VALUE" \
-H "Authorization: Bearer YOUR_API_KEY"
```
```jsonc MCP theme={null}
// Copy this whole block into Claude Code, Codex, Cursor or any coding agent.
// It carries everything needed to connect, authorize and run this example —
// no key to paste, one click of Allow in the browser.
{
"operation_id": "get_pinterest_search",
"arguments": {
"query": "VALUE"
},
"max_price_usd": 0.05
}
// ── for the agent ─────────────────────────────────────────────────────────
// Register the AIsa MCP server, then call its `use` tool with the JSON above.
// name aisa
// endpoint https://mcp.aisa.one/mcp
// transport streamable-http
// auth OAuth. The server publishes RFC 9728 metadata, so open a
// browser and the user clicks Allow once — nothing to paste.
// If AISA_API_KEY is set, send it as a bearer header instead.
// Use your own MCP mechanism, not a hand-edited config file:
// Codex codex mcp add aisa --url https://mcp.aisa.one/mcp
// Claude Code claude mcp add --transport http -s user aisa https://mcp.aisa.one/mcp
// Cursor / VS Code a "url" entry for https://mcp.aisa.one/mcp in the MCP config
// The server lists five tools over https://mcp.aisa.one/servers worth of APIs:
// search, get_details, use, batch_use, list_categories. search and
// get_details are free; use is billed per call and max_price_usd refuses
// anything above the cap before spending. This operation's full contract —
// every argument, the response shape, the price and the pitfalls — is at
// https://aisa.one/docs/api-reference/pinterest/get_pinterest-search.md
// Then run the call and show me the result.
```
**First time?** Point any MCP client at `https://mcp.aisa.one/mcp` — Claude
Code, Codex, Cursor, VS Code and the rest. Authorization is OAuth: the client
opens a browser, you click Allow once, and there is no key to paste. The
commands per client, and what each call costs, are on
[aisa.one/mcp](https://aisa.one/mcp#connect).
[Set this endpoint up in your agent →](https://aisa.one/mcp?from=/api-reference/pinterest/get_pinterest-search)
## OpenAPI
````yaml openapi/scrape-creators.json GET /apis/v1/pinterest/search
openapi: 3.1.0
info:
description: ''
title: Scrape Creators
version: '1'
x-aisa-capabilities:
idempotency: Idempotency-Key
max_price: X-AISA-Max-Price-USD
quote:
header: X-AISA-Cost-Mode
value: quote
x-aisa-configured-paths:
- /apis/v1/instagram/basic-profile
- /apis/v1/instagram/media/transcript
- /apis/v1/instagram/post
- /apis/v1/instagram/post/comments
- /apis/v1/instagram/profile
- /apis/v1/instagram/reels/search
- /apis/v1/instagram/reels/trending
- /apis/v1/instagram/search/hashtag
- /apis/v1/instagram/search/profiles
- /apis/v1/instagram/song/reels
- /apis/v1/instagram/user/embed
- /apis/v1/instagram/user/highlight/detail
- /apis/v1/instagram/user/highlights
- /apis/v1/instagram/user/posts
- /apis/v1/instagram/user/reels
- /apis/v1/pinterest/board
- /apis/v1/pinterest/pin
- /apis/v1/pinterest/search
- /apis/v1/pinterest/user/boards
- /apis/v1/reddit/post/comments
- /apis/v1/reddit/search
- /apis/v1/reddit/subreddit
- /apis/v1/reddit/subreddit/details
- /apis/v1/reddit/subreddit/search
x-aisa-document:
facts_hash: 64320c0fb95b4974f2c3dadb5a11bd791d41a0db99113a1368ae06d198565038
generator_version: '2'
protocol_version: '1'
schema_version: '1'
composer_version: '13'
response_pending: []
document_hash: sha256:0598c689a8ba0f767889045187d8507dc216630bc409346fcab57552dbb2f19f
identity_base_document_hash: sha256:b33e8747e079279c723d19dd0a27a544d76426c86c81553192be05c5afb2d6b5
identity_compatibility_hash: sha256:6c09ef0bdf18266535eb126de4c7347ff1c7d0e62dd283fee668032d3d4408c5
x-aisa-plans:
builder: 1
display_plan: payg
payg: 1
similarweb_payg: 1
team: 1
version: e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb
x-aisa-provider: scrape-creators
x-aisa-catalogs:
scrape-creators:
title: Scrape Creators
description: ''
x-aisa-document:
facts_hash: 64320c0fb95b4974f2c3dadb5a11bd791d41a0db99113a1368ae06d198565038
generator_version: '2'
protocol_version: '1'
schema_version: '1'
x-aisa-plans:
builder: 1
display_plan: payg
payg: 1
similarweb_payg: 1
team: 1
version: e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb
x-aisa-capabilities:
idempotency: Idempotency-Key
max_price: X-AISA-Max-Price-USD
quote:
header: X-AISA-Cost-Mode
value: quote
servers:
- url: https://api.aisa.one
security:
- bearerAuth: []
paths:
/apis/v1/pinterest/search:
get:
tags:
- default
summary: search
description: >-
Searches Pinterest for pins matching a keyword and returns pins plus a
cursor to page. Each pin carries id, url, title, description,
grid_title, created_at, images in five sizes (170x, 236x, 474x, 736x,
orig), link, domain, board (name, url, pin_count) and pinner (username).
Measured at about 110 KB for 17 pins; trim=true cuts that to 28 KB and
keeps six fields per pin — id, url, description, created_at, images and
pinner — dropping title, link, board and domain, so only skip trim when
you need those. The board.url on each result feeds get_pinterest_board;
for one pin's engagement counts use get_pinterest_pin.
operationId: get_pinterest_search
parameters:
- in: query
name: limit
required: false
schema:
type: string
- in: query
name: query
required: false
schema:
type: string
- in: query
name: trim
required: false
schema:
type: string
responses:
'200':
description: Successful response
content:
application/json:
example:
success: true
pins:
- id: '643874078015272259'
url: https://www.pinterest.com/pin/643874078015272259
description: >-
#cute #animal #dog #puppy #pfp #icon #dogpfp #silly
#cutepuppy #bordercollie #fyp #trend
created_at: Tue, 10 Jun 2025 21:45:32 +0000
pinner:
node_id: VXNlcjo2NDM4NzQyMTUzODQxMzkwMTg=
full_name: Annika Strøm
is_ads_only_profile: false
username: annikastrom2
image_medium_url: >-
https://i.pinimg.com/75x75_RS/60/d5/a8/60d5a8405ec70c5c46b677186c626587.jpg
is_primary_website_verified: false
follower_count: 2
ads_only_profile_site: null
id: '643874215384139018'
is_verified_merchant: false
image_large_url: >-
https://i.pinimg.com/140x140_RS/60/d5/a8/60d5a8405ec70c5c46b677186c626587.jpg
verified_identity: {}
image_small_url: >-
https://i.pinimg.com/30x30_RS/60/d5/a8/60d5a8405ec70c5c46b677186c626587.jpg
images:
170x:
width: 236
height: 312
url: >-
https://i.pinimg.com/236x/a7/d6/dc/a7d6dced1ee95c11a150dcf2f1c6e05f.jpg
236x:
width: 236
height: 312
url: >-
https://i.pinimg.com/236x/a7/d6/dc/a7d6dced1ee95c11a150dcf2f1c6e05f.jpg
474x:
width: 474
height: 626
url: >-
https://i.pinimg.com/474x/a7/d6/dc/a7d6dced1ee95c11a150dcf2f1c6e05f.jpg
736x:
width: 736
height: 973
url: >-
https://i.pinimg.com/736x/a7/d6/dc/a7d6dced1ee95c11a150dcf2f1c6e05f.jpg
orig:
width: 946
height: 1251
url: >-
https://i.pinimg.com/originals/a7/d6/dc/a7d6dced1ee95c11a150dcf2f1c6e05f.jpg
cursor: Y2JVSG81V2sxcmNHRlpWM1J5VFVad1ZsWl...
schema:
$ref: >-
#/components/schemas/ResponseD03A0F58B24A_PinterestPinsResponse
default:
content:
application/json:
schema: {}
description: >-
Error response; upstream passthrough responses may use provider
formats
components:
schemas:
ResponseD03A0F58B24A_PinterestPinsResponse:
type: object
properties:
success:
type: boolean
credits_remaining:
type: integer
pins:
type: array
items:
type: object
additionalProperties: true
cursor:
type:
- string
- 'null'
additionalProperties: true
securitySchemes:
bearerAuth:
scheme: bearer
type: http
````
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.