Skip to main content
GET
Search
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; for one pin’s engagement counts use get_pinterest_pin.

Example

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.
Set this endpoint up in your agent →

Authorizations

Authorization
string
header
required

AIsa API key. Get yours at https://aisa.one

Query Parameters

query
string
required

Search query

cursor
string

Cursor

trim
boolean

Set to true for a trimmed down version of the response

Response

200 - application/json

Successful response

success
boolean
credits_remaining
integer
pins
object[]
cursor
string | null