{
"opencollection": "1.0.0",
"info": {
"name": "Pinterest Items API",
"version": "5.13.0"
},
"items": [
{
"info": {
"name": "Items",
"type": "folder"
},
"items": [
{
"info": {
"name": "Get catalogs items",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://api.pinterest.com/v5/catalogs/items",
"params": [
{
"name": "ad_account_id",
"value": "",
"type": "query",
"description": "Unique identifier of an ad account."
},
{
"name": "country",
"value": "US",
"type": "query",
"description": "Country for the Catalogs Items"
},
{
"name": "language",
"value": "EN",
"type": "query",
"description": "Language for the Catalogs Items"
},
{
"name": "item_ids",
"value": "CR123",
"type": "query",
"description": "This parameter is deprecated. Use filters instead."
},
{
"name": "filters",
"value": "",
"type": "query",
"description": "Identifies items to be retrieved. This is a required parameter."
}
],
"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": "Get the items of the catalog owned by the \"operation user_account\". See detailed documentation here.\n- By default, the \"operation user_account\" is the token user_account.\n\nOptional: Business Access: Specify an ad_account_id (obtained via List ad accounts) to use the owner of that ad_account as the \"operation user_account\". In order to do this, the "
},
{
"info": {
"name": "Get catalogs items (POST)",
"type": "http"
},
"http": {
"method": "POST",
"url": "https://api.pinterest.com/v5/catalogs/items",
"params": [
{
"name": "ad_account_id",
"value": "",
"type": "query",
"description": "Unique identifier of an ad account."
}
],
"body": {
"type": "json",
"data": "{}"
},
"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": "Get the items of the catalog owned by the \"operation user_account\". See detailed documentation here.\n- By default, the \"operation user_account\" is the token user_account.\n\nOptional: Business Access: Specify an ad_account_id (obtained via List ad accounts) to use the owner of that ad_account as the \"operation user_account\". In order to do this, the "
},
{
"info": {
"name": "Operate on item batch",
"type": "http"
},
"http": {
"method": "POST",
"url": "https://api.pinterest.com/v5/catalogs/items/batch",
"params": [
{
"name": "ad_account_id",
"value": "",
"type": "query",
"description": "Unique identifier of an ad account."
}
],
"body": {
"type": "json",
"data": "{}"
},
"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 supports multiple operations on a set of one or more catalog items owned by the \"operation user_account\". See detailed documentation here.\n- By default, the \"operation user_account\" is the token user_account.\n\nOptional: Business Access: Specify an ad_account_id (obtained via List ad accounts) to use the owner of that ad_account as the"
},
{
"info": {
"name": "Get catalogs item batch status",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://api.pinterest.com/v5/catalogs/items/batch/:batch_id",
"params": [
{
"name": "batch_id",
"value": "595953100599279259-66753b9bb65c46c49bd8503b27fecf9e",
"type": "path",
"description": "Id of a catalogs items batch to fetch"
},
{
"name": "ad_account_id",
"value": "",
"type": "query",
"description": "Unique identifier of an ad account."
}
],
"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": "Get a single catalogs items batch owned by the \"operating user_account\". See detailed documentation here.\n- By default, the \"operation user_account\" is the token user_account.\n\nOptional: Business Access: Specify an ad_account_id (obtained via List ad accounts) to use the owner of that ad_account as the \"operation user_account\". In order to do this,"
}
]
}
],
"bundled": true
}