Inspect single Pinterest pin metadata, color swatches & outbound product URL

GET/v1/pins/details· Updated 2026-11-15

Fetches full normalized metadata for a single Pinterest pin by numeric pin_id, Pin token, or full https://www.pinterest.com/pin/{id}/ URL. Cost: 5 Credits (0 Credits if not found).

Parameters

pin_idstringrequired
Pinterest Pin ID, token, or full Pinterest Pin URL (also accepts id or url).

Example Request (cURL / Python / JavaScript)

curl "https://api.pindataapi.com/v1/pins/details?pin_id=" \
  -H "x-api-key: pn_live_your_api_key"

import requests

res = requests.get(
    "https://api.pindataapi.com/v1/pins/details?pin_id=",
    headers={"x-api-key": "pn_live_your_api_key"},
    timeout=30,
)
print(res.json())

const res = await fetch("https://api.pindataapi.com/v1/pins/details?pin_id=", {
  headers: { "x-api-key": "pn_live_your_api_key" },
});
const data = await res.json();
console.log(data);

Live Response Preview

{
  "code": 0,
  "provider": "https://pindataapi.com",
  "status": "ok",
  "msg": "success",
  "data": {
    "pin": {
      "board": {
        "url": "https://www.pinterest.com/preview_garmentory_com/_products_coffee-tea-cups/",
        "name": "Coffee & Tea Cups",
        "board_id": "872783671476146896",
        "pin_count": 2707
      },
      "title": "LEMON COFFEE MUG",
      "width": 1080,
      "height": 1620,
      "pin_id": "e1_AfqPShwhDXqkIA5FsIxyvJT-zZSIZUd-KpOe2rI_meOHpzVVwnCd",
      "creator": {
        "username": "preview_garmentory_com",
        "followers": 327,
        "full_name": "Pinterest Preview Garmentory",
        "avatar_url": "https://s.pinimg.com/images/user/default_140.png",
        "verified_merchant": false
      },
      "pin_url": "https://www.pinterest.com/pin/e1_AfqPShwhDXqkIA5FsIxyvJT-zZSIZUd-KpOe2rI_meOHpzVVwnCd/",
      "alt_text": "a blue and white coffee cup with an orange design on the inside, sitting on a table",
      "image_url": "https://i.pinimg.com/originals/69/ba/88/69ba885b9ab40879c14b8979873039c1.jpg",
      "created_at": "Wed, 01 Oct 2025 22:22:19 +0000",
      "numeric_id": null,
      "description": "Elevate your coffee or tea experience with the Casa Amarosa Lemon Coffee Mug. Made from high-quality stoneware, this mug is sleek and durableperfect for any modern home or office. The wide opening and ergonomic handle make it easy and comfortable to use. Material: Stoneware Size: 3.5 Inch x 3 Inch Capacity: 250 ml Color: Yellow Handmade by artisans. Perfect cup for coffee and tea.",
      "palette_hex": [
        "#C9B096",
        "#FFFFFF",
        "#EAEAEB",
        "#EAEAEC",
        "#3A7FC2"
      ],
      "price_value": null,
      "saves_count": 1,
      "aspect_ratio": "2:3",
      "is_shoppable": true,
      "outbound_url": "https://garmentory.com/sale/casa-amarosa/drinkware-coffee-tea/2651956-casa-amarosa-lemon-coffee-mug",
      "search_query": "ceramic mug",
      "thumbnail_url": "https://i.pinimg.com/236x/69/ba/88/69ba885b9ab40879c14b8979873039c1.jpg",
      "comments_count": 0,
      "dominant_color": "#C9B096",
      "price_currency": null,
      "merchant_domain": "garmentory.com",
      "reactions_count": 1
    }
  },
  "meta": {
    "request_id": "dfebd84b-2cc9-4d5b-a817-7750c16134e0",
    "endpoint": "/v1/pins/details",
    "credits_charged": 5,
    "cached": true,
    "took_ms": 3
  }
}

Response Fields

Normalized single Pinterest pin object.

Field	Type	Sample / Notes
`code`	integer	Example: 0
`provider`	string
`status`	string	Example: ok
`data`	object
`pin`	NormalizedPin
`pin_id`	string
`numeric_id`	stringnull
`title`	string
`description`	stringnull
`alt_text`	stringnull
`dominant_color`	string	Example: #C9B096
`palette_hex`	array of string
`image_url`	string
`thumbnail_url`	stringnull
`width`	integer	Example: 1080
`height`	integer	Example: 1620
`aspect_ratio`	string	Example: 2:3
`saves_count`	integer
`comments_count`	integer
`reactions_count`	integer
`is_shoppable`	boolean
`merchant_domain`	stringnull	Example: garmentory.com
`outbound_url`	stringnull
`pin_url`	string
`creator`	object
`board`	object
`meta`	ResponseMeta
`request_id`	string
`endpoint`	string
`credits_charged`	integer
`cached`	boolean
`took_ms`	integer

Status Codes

200: Normalized single Pinterest pin object.
401
404