Docs/Pinterest Search
Docs / API reference
POST/v1/data/pinterest/search
Pinterest Search
Search public Pinterest pins by keyword. Returns title, description, alt text, images, destination link, board, owner, and dominant color.
Execution model
Live request
Runtime depends on endpoint, target, pagination, rendering mode, and active plan limits.
Credit weight
Live catalog
Current weights are managed from the Data API Weights admin table and shown on pricing before use.
Parameters
| Name | Type | Requirement | Description |
|---|---|---|---|
| query | string | Required | Search keywords. 1-500 characters. |
| limit | number | Optional | Maximum pins to return (1-100). |
Response fields
| Field | Type | Description |
|---|---|---|
| query / count | string / number | Your query and number of pins returned. |
| results[] | array | id, url, title, description, alt_text, image, image_thumb, image_width, image_height, dominant_color, link, domain, board, owner, created_at, repin_count, reactions. |
| results[].is_promoted / is_product | boolean | Always present: whether the pin is an ad and whether it is a product pin. |
| results[].link / domain | string | Optional: the pin's outbound destination; omitted for pins without one. |
Request and response
curl -X POST "https://api.datablue.dev/v1/data/pinterest/search" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"query": "minimalist living room",
"limit": 25
}'Example response
{
"success": true,
"time_taken": 1.58,
"query": "minimalist living room",
"count": 1,
"results": [
{
"id": "1234567890123456789",
"url": "https://www.pinterest.com/pin/1234567890123456789/",
"title": "Minimalist living room ideas",
"description": "Neutral tones and natural light.",
"alt_text": "Living room with a beige sofa and wooden coffee table",
"image": "https://i.pinimg.com/originals/ab/cd/ef/example.jpg",
"image_thumb": "https://i.pinimg.com/236x/ab/cd/ef/example.jpg",
"image_width": 1000,
"image_height": 1500,
"dominant_color": "#d8d2c8",
"link": "https://example.com/minimalist-living-room",
"domain": "example.com",
"board": "Living Room",
"owner": "exampledesigns",
"created_at": "Mon, 06 Oct 2025 12:00:00 +0000",
"repin_count": 320,
"reactions": 45,
"is_promoted": false,
"is_product": false
}
]
}