Pinterest API endpoint
Returns public Pinterest pins matching a text query: title, description, image, board, and pinner for each result. Public data sourced from Pinterest's own web search.
/pinterest/searchQuery parameters:
query (required) — search text.Notable response behavior:
image_url is the largest reasonably-sized image Pinterest returned for
the pin (preferring 736x, falling back through 474x/orig/236x/170x).title can be empty — many pins carry only a description, not a
separate title.domain/link point at the pin's off-Pinterest source when the pin was
saved from a website; pins uploaded directly by a user instead carry
"domain": "Uploaded by user" with no link.query returns 400 before any upstream request is made.| Field | Filled in, of 23 checked | Values in the sample |
|---|---|---|
| id | 23 | |
| url | 23 | pinterest.com |
| title | 20 | |
| description | 19 | median 459 characters |
| image_url | 23 | i.pinimg.com |
| dominant_color | 23 | |
| domain | 23 | |
| link | 6 | nhuedesignlab.etsy.com and 5 other hosts |
| board_name | 23 | |
| pinner_username | 23 |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| query | string | Yes | Search text | minimalist living room | |
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/pinterest/search?query=minimalist+living+room" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"query": "minimalist living room",
"pins": [
{
"id": "21673641953485811",
"url": "https://www.pinterest.com/pin/21673641953485811/",
"title": "Minimalist Luxury Living Spaces That Look Clean But Still Cozy",
"description": "Minimalist Luxury Living Spaces can feel cozy when the room uses texture, lighting, and practical furniture instead of extra clutter.",
"image_url": "https://i.pinimg.com/736x/da/b7/2a/dab72a3f9f2b9f18274752facb0349ef.jpg",
"dominant_color": "#957653",
"domain": "impactdriverdrill.com",
"link": "https://impactdriverdrill.com/minimalist-luxury-living-spaces/",
"board_name": "Løkken hus",
"pinner_username": "annlizeth9550"
}
]
}
}Request schema
No body schema
Response schema
#/definitions/pinterest.searchResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | pinterest.SearchResponse | 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.query | string | No | ||||
| msg | string | No | OK |
| Status | Description | Schema |
|---|---|---|
| 400 | Bad Request | #/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/search?query=minimalist+living+room" \
-H "x-api-key: $CRAWLORA_API_KEY"