Pinterest API endpoint
Returns a page of a Pinterest user's own pins: title, description, image, board, and pinner for each. Public data sourced from Pinterest's own profile pages.
/pinterest/user/{username}/pinsPath parameters:
username (required) — a Pinterest username.Notable response behavior:
pinner_username on each pin always matches the requested username.username returns 400 before any upstream request is made.| Field | Filled in, of 25 checked | Values in the sample |
|---|---|---|
| id | 25 | |
| url | 25 | pinterest.com |
| title | 25 | |
| image_url | 25 | i.pinimg.com |
| dominant_color | 25 | |
| domain | 25 | |
| board_name | 25 | |
| pinner_username | 25 | |
| description | 8 | |
| link | 6 | patrontequila.com |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| username (path) | string | Yes | Pinterest username | patrontequila | |
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/pinterest/user/patrontequila/pins" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"username": "patrontequila",
"pins": [
{
"id": "52846995624312550",
"url": "https://www.pinterest.com/pin/52846995624312550/",
"title": "Summer freshness, stirred. Enjoy a PATRÓN® Strawberry Margarita.",
"description": "Discover a fresh flavorful sip for the hot weather. Find recipe here.",
"image_url": "https://i.pinimg.com/736x/ee/06/7d/ee067d96fc479b935075a9eefb309c87.jpg",
"dominant_color": "#ffffff",
"domain": "patrontequila.com",
"link": "https://www.patrontequila.com/cocktails/patron-silver/strawberry-margarita.html",
"board_name": "Summer Cocktails",
"pinner_username": "patrontequila"
}
]
}
}Request schema
No body schema
Response schema
#/definitions/pinterest.userPinsResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | pinterest.UserPinsResponse | No | ||||
| data.pins | array | No | Pins from the user's profile. | |||
| data.pins[].board_name | string | No | Name of the board the pin is saved to. | |||
| data.pins[].description | string | No | Description text of the pin as Pinterest shows it. | |||
| data.pins[].domain | string | No | Domain of the website the pin links to, or `Uploaded by user` for pins uploaded directly. | |||
| data.pins[].dominant_color | string | No | Dominant color of the pin image, as a hex code such as `#6a2f18`. | |||
| data.pins[].id | string | No | Pinterest pin id. | |||
| data.pins[].image_url | string | No | URL of the pin image. | |||
| data.pins[].link | string | No | Destination URL the pin links to. | |||
| data.pins[].pinner_username | string | No | Username of the account that saved the pin. | |||
| data.pins[].title | string | No | Title of the pin as Pinterest shows it. | |||
| data.pins[].url | string | No | URL of the pin's page on Pinterest. | |||
| data.username | string | No | Pinterest username that was requested. | |||
| 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/user/patrontequila/pins" \
-H "x-api-key: $CRAWLORA_API_KEY"