{
"opencollection": "1.0.0",
"info": {
"name": "Pinterest Search API",
"version": "5.13.0"
},
"items": [
{
"info": {
"name": "Search",
"type": "folder"
},
"items": [
{
"info": {
"name": "Search user's boards",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://api.pinterest.com/v5/search/boards",
"params": [
{
"name": "ad_account_id",
"value": "",
"type": "query",
"description": "Unique identifier of an ad account."
},
{
"name": "bookmark",
"value": "",
"type": "query",
"description": "Cursor used to fetch the next page of items"
},
{
"name": "page_size",
"value": "",
"type": "query",
"description": "Maximum number of items to include in a single page of the response. See documentation on Pagination for more information."
},
{
"name": "query",
"value": "",
"type": "query",
"description": "Search query. Can contain pin description keywords or comma-separated pin IDs."
}
],
"auth": {
"type": "oauth2",
"flow": "authorization_code",
"authorizationUrl": "https://www.pinterest.com/oauth/",
"accessTokenUrl": "https://api.pinterest.com/v5/oauth/token",
"credentials": {
"clientId": "{{clientId}}",
"clientSecret": "{{clientSecret}}"
}
}
},
"docs": "Search for boards for the \"operation user_account\". This includes boards of all board types.\n- By default, the \"operation user_account\" is the token user_account.\n\nIf using Business Access: Specify an ad_account_id to use the owner of that ad_account as the \"operation user_account\". See Understanding Business Access for more information."
},
{
"info": {
"name": "Search user's Pins",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://api.pinterest.com/v5/search/pins",
"params": [
{
"name": "ad_account_id",
"value": "",
"type": "query",
"description": "Unique identifier of an ad account."
},
{
"name": "query",
"value": "Plants",
"type": "query",
"description": "Search query. Can contain pin description keywords or comma-separated pin IDs."
},
{
"name": "bookmark",
"value": "",
"type": "query",
"description": "Cursor used to fetch the next page of items"
}
],
"auth": {
"type": "oauth2",
"flow": "authorization_code",
"authorizationUrl": "https://www.pinterest.com/oauth/",
"accessTokenUrl": "https://api.pinterest.com/v5/oauth/token",
"credentials": {
"clientId": "{{clientId}}",
"clientSecret": "{{clientSecret}}"
}
}
},
"docs": "Search for pins for the \"operation user_account\".\n- By default, the \"operation user_account\" is the token user_account.\n\nIf using Business Access: Specify an ad_account_id to use the owner of that ad_account as the \"operation user_account\". See Understanding Business Access for more information."
},
{
"info": {
"name": "Search pins by a given search term",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://api.pinterest.com/v5/search/partner/pins",
"params": [
{
"name": "term",
"value": "",
"type": "query",
"description": "Search term to look up pins."
},
{
"name": "country_code",
"value": "US",
"type": "query",
"description": "Two letter country code (ISO 3166-1 alpha-2)"
},
{
"name": "bookmark",
"value": "",
"type": "query",
"description": "Cursor used to fetch the next page of items"
},
{
"name": "locale",
"value": "",
"type": "query",
"description": "Search locale."
},
{
"name": "limit",
"value": "4",
"type": "query",
"description": "Max search result size"
}
],
"auth": {
"type": "oauth2",
"flow": "authorization_code",
"authorizationUrl": "https://www.pinterest.com/oauth/",
"accessTokenUrl": "https://api.pinterest.com/v5/oauth/token",
"credentials": {
"clientId": "{{clientId}}",
"clientSecret": "{{clientSecret}}"
}
}
},
"docs": "This endpoint is currently in beta and not available to all apps. Learn more.\n\nGet the top 10 Pins by a given search term."
}
]
}
],
"bundled": true
}