search
Search pins by a given search term
This endpoint is currently in beta and not available to all apps. Learn more.
Get the top 10 Pins by a given search term.
get/search/partner/pins
Query parameters
termstring required
Search term to look up pins.
country_codestring required
Two letter country code (ISO 3166-1 alpha-2)
bookmarkstring
Cursor used to fetch the next page of items
localestring
Search locale.
limitinteger
Max search result size
Response
The request has succeeded.
Example response
{
"items": [
{
"media": {
"images": {
"150x150": {
"width": 150,
"height": 150,
"url": "https://i.pinimg.com/150x150/0d/f6/f1/0df6f1f0bfe7aaca849c1bbc3607a34b.jpg"
},
"400x300": {
"width": 400,
"height": 300,
"url": "https://i.pinimg.com/400x300/0d/f6/f1/0df6f1f0bfe7aaca849c1bbc3607a34b.jpg"
},
"600x": {
"width": 600,
"height": 600,
"url": "https://i.pinimg.com/600x/0d/f6/f1/0df6f1f0bfe7aaca849c1bbc3607a34b.jpg"
},
"1200x": {
"width": 1200,
"height": 1200,
"url": "https://i.pinimg.com/1200x/0d/f6/f1/0df6f1f0bfe7aaca849c1bbc3607a34b.jpg"
}
}
}
}
]
}