{ "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 }