Pinterest API endpoint
Returns Pinterest's top-level "Ideas" category taxonomy (e.g. "Animals", "Home Decor", "Food And Drink"). Each entry's id is usable directly with GET /pinterest/ideas/{id}. Public data sourced from Pinterest's own ideas.pinterest.com-style category hub.
/pinterest/categoriesRequires the x-api-key header. No query or path parameters.
Notable response behavior:
id is the value to pass as the id path parameter to
/pinterest/ideas/{id}.| Field | Filled in, of 10 checked |
|---|---|
| id | 10 |
| slug | 10 |
| name | 10 |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/pinterest/categories" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"categories": [
{
"id": "925056443165",
"slug": "animals",
"name": "Animals"
},
{
"id": "961238559656",
"slug": "art",
"name": "Art"
},
{
"id": "935541271955",
"slug": "beauty",
"name": "Beauty"
},
{
"id": "902065567321",
"slug": "design",
"name": "Design"
},
{
"id": "934876475639",
"slug": "diy-and-crafts",
"name": "Diy And Crafts"
},
{
"id": "918530398158",
"slug": "food-and-drink",
"name": "Food And Drink"
},
{
"id": "935249274030",
"slug": "home-decor",
"name": "Home Decor"
},
{
"id": "924581335376",
"slug": "mens-fashion",
"name": "Mens Fashion"
},
{
"id": "948192800438",
"slug": "quotes",
"name": "Quotes"
},
{
"id": "922203297757",
"slug": "tattoos",
"name": "Tattoos"
}
]
}
}Request schema
No body schema
Response schema
#/definitions/pinterest.categoriesResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | pinterest.CategoriesResponse | No | ||||
| data.categories | array | No | Top-level Pinterest Ideas categories. | |||
| data.categories[].id | string | No | Pinterest category id. Use it with the ideas endpoint. | |||
| data.categories[].name | string | No | Category name as shown on Pinterest. | |||
| data.categories[].slug | string | No | URL slug of the category. | |||
| msg | string | No | OK |
| Status | Description | Schema |
|---|---|---|
| 500 | Internal Server Error | #/definitions/app.Response |
| 503 | Service Unavailable | #/definitions/app.Response |
Use environment variables for secrets and keep Crawlora API keys server-side.
curl -X GET "https://api.crawlora.net/api/v1/pinterest/categories" \
-H "x-api-key: $CRAWLORA_API_KEY"