Pinterest API endpoint
Returns one "Ideas" category's metadata (name, description, follower count) plus a page of pins from that category's feed. Public data sourced from Pinterest's own ideas category pages.
/pinterest/ideas/{id}Path parameters:
id (required) — a Pinterest ideas category id. See
GET /pinterest/categories for the full list.Notable response behavior:
follower_count reflects Pinterest's own follower count for the
category as a whole, not the requester.id returns 404.id returns 400 before any upstream request is made.| Field | Filled in, of 13 checked | Values in the sample |
|---|---|---|
| id | 13 | |
| url | 13 | pinterest.com |
| title | 4 | |
| description | 4 | |
| image_url | 13 | i.pinimg.com |
| dominant_color | 13 | |
| domain | 13 | |
| board_name | 13 | |
| pinner_username | 13 | |
| link | 4 | pinterest.com and 3 other hosts |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| id (path) | string | Yes | Pinterest ideas category id. See GET /pinterest/categories for the full list. | 925056443165 | |
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/pinterest/ideas/925056443165" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"id": "925056443165",
"name": "Animals",
"description": "Animals are the best. Boost your mood with funny cat memes, or learn everything you need to know about caring for the family pet.",
"follower_count": 138678383,
"pins": [
{
"id": "97531148175959884",
"url": "https://www.pinterest.com/pin/97531148175959884/",
"title": "world otter day",
"description": "otters",
"image_url": "https://i.pinimg.com/474x/11/1a/26/111a261d48f2ddb20e427ccc1692665b.jpg",
"dominant_color": "#888b7e",
"domain": "Uploaded by user",
"board_name": "animals + insects",
"pinner_username": "bellamwelsh"
}
]
}
}Request schema
No body schema
Response schema
#/definitions/pinterest.ideaResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | pinterest.IdeaResponse | No | ||||
| data.description | string | No | ||||
| data.follower_count | integer | No | ||||
| data.id | string | No | ||||
| data.name | string | No | ||||
| data.pins | array | No | PinSummary record, 10 fields: board_name, description, domain, dominant_color, id, image_url, link, pinner_username, title, url. Described under Pinterest user pins API. | |||
| msg | string | No | OK |
| Status | Description | Schema |
|---|---|---|
| 400 | Bad Request | #/definitions/app.Response |
| 404 | Not Found | #/definitions/app.Response |
| 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/ideas/925056443165" \
-H "x-api-key: $CRAWLORA_API_KEY"