Pinterest Scraper API Guide (2026): Extract Pins, Boards, Creators & Merchant Links Cleanly

import os, requests

API_KEY = os.environ["PINDATA_API_KEY"]
cursor = None
shoppable_pins = []

for page in range(3):
    params = {"query": "stoneware lamp", "limit": 20}
    if cursor:
        params["cursor"] = cursor
    res = requests.get(
        "https://api.pindataapi.com/v1/pins/search",
        params=params,
        headers={"x-api-key": API_KEY},
        timeout=20,
    ).json()
    data = res["data"]
    shoppable_pins.extend([p for p in data["pins"] if p.get("merchant_domain")])
    cursor = data.get("next_cursor")
    if not cursor:
        break

print(f"Collected {len(shoppable_pins)} shoppable pins")

const headers = { "x-api-key": process.env.PINDATA_API_KEY! };
let cursor: string | null = null;
const collected = [];

for (let page = 0; page < 3; page++) {
  const qs = new URLSearchParams({ query: "stoneware lamp", limit: "20" });
  if (cursor) qs.set("cursor", cursor);
  const res = await fetch(`https://api.pindataapi.com/v1/pins/search?${qs}`, { headers });
  const { data } = await res.json();
  collected.push(...data.pins);
  cursor = data.next_cursor;
  if (!cursor) break;
}

curl "https://api.pindataapi.com/v1/pins/search?query=stoneware+lamp&limit=20" \
  -H "x-api-key: pn_live_your_api_key"

{
  "code": 0,
  "status": "ok",
  "data": {
    "query": "stoneware lamp",
    "count": 20,
    "next_cursor": "Y2JVSG81V2sxcmNHRlpWM1J5...",
    "dominant_palette_summary": ["#C9B096", "#D4A373", "#867F73", "#54493C"],
    "pins": [
      {
        "pin_id": "e1_AfqPShz5xeQTD1FJZlTKN6s0JR3fUX4uFFX1KnVLp1Tp_jZHb_B2Dw",
        "title": "Short Mug in Sandstone",
        "width": 1825,
        "height": 2738,
        "aspect_ratio": "2:3",
        "dominant_color": "#C5C4C4",
        "palette_hex": ["#C5C4C4", "#E5E5E0", "#CFD4D9", "#C2CBC9", "#F4EFE7"],
        "is_shoppable": true,
        "merchant_domain": "hoppeshoppe.com"
      }
    ]
  }
}