Pinterest API endpoint
Returns a Pinterest board's metadata (name, description, cover image, pin/follower counts, owner) plus a page of pins from that board. Public data sourced from Pinterest's own board pages.
/pinterest/board/{username}/{slug}Path parameters:
username (required) — the Pinterest username that owns the board.slug (required) — the board's URL slug, from the board's own
/{username}/{slug}/ URL, or from a
/pinterest/user/{username}/boards result's
url field.Notable response behavior:
username/slug pair returns 404.username or slug returns 400 before any upstream request
is made.| Field | Filled in, of 6 checked | Values in the sample |
|---|---|---|
| id | 6 | |
| url | 6 | pinterest.com |
| image_url | 6 | i.pinimg.com |
| dominant_color | 6 |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| username (path) | string | Yes | Pinterest username that owns the board | patrontequila | |
| slug (path) | string | Yes | Board URL slug, from the board's own /{username}/{slug}/ URL | el-cafecito | |
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/pinterest/board/patrontequila/el-cafecito" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"id": "52847064316842646",
"url": "/patrontequila/el-cafecito/",
"name": "EL CAFECITO",
"cover_image_url": "https://i.pinimg.com/200x150/4b/92/d4/4b92d41f01669ea16371351e138a8f12.jpg",
"pin_count": 6,
"follower_count": 10372,
"privacy": "public",
"owner_username": "patrontequila",
"pins": [
{
"id": "52846995624279072",
"url": "https://www.pinterest.com/pin/52846995624279072/",
"title": "Milk Punch Recipe",
"image_url": "https://i.pinimg.com/736x/de/08/76/de08769d89808e1373c95fdb53c1f324.jpg",
"dominant_color": "#6a2f18",
"domain": "Uploaded by user",
"board_name": "EL CAFECITO",
"pinner_username": "patrontequila"
}
]
}
}Request schema
No body schema
Response schema
#/definitions/pinterest.boardResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | pinterest.BoardResponse | No | ||||
| data.cover_image_url | string | No | ||||
| data.description | string | No | ||||
| data.follower_count | integer | No | ||||
| data.id | string | No | ||||
| data.name | string | No | ||||
| data.owner_username | string | No | ||||
| data.pin_count | integer | 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. | |||
| data.privacy | string | No | ||||
| data.url | string | No | ||||
| 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/board/patrontequila/el-cafecito" \
-H "x-api-key: $CRAWLORA_API_KEY"