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

NameTypeRequirementDescription
querystringRequiredSearch keywords. 1-500 characters.
limitnumberOptionalMaximum pins to return (1-100).

Response fields

FieldTypeDescription
query / countstring / numberYour query and number of pins returned.
results[]arrayid, 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_productbooleanAlways present: whether the pin is an ad and whether it is a product pin.
results[].link / domainstringOptional: 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
    }
  ]
}