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

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