Migrate from Apify Pinterest & Airbnb Actors to <1s Synchronous REST JSON.

# BEFORE (Async Actor job: 15–45s container boot + dataset polling + residential proxy CU burn)
# run = ApifyClient(TOKEN).actor("...").call(run_input={
#     "search": "japanese ceramic mug",
#     "maxItems": 20,
# })
# items = list(client.dataset(run["defaultDatasetId"]).iterate_items())

# AFTER (PinData API: <1s synchronous HTTP GET — 0 container boot fees, zero OAuth wait)
import os
import requests

API_KEY = os.environ["PINDATAAPI_KEY"]  # pn_live_... (12,000 free credits on signup)
HEADERS = {"Authorization": f"Bearer {API_KEY}"}

# 1. Search Pinterest visual pins with 5-swatch hex palettes & shop-the-look domains
pins_resp = requests.get(
    "https://api.pindataapi.com/v1/pins/search",
    params={"query": "japanese ceramic mug", "limit": 20},
    headers=HEADERS,
    timeout=15,
)
pins_resp.raise_for_status()
pins = pins_resp.json()["data"]["pins"]

# 2. Search boutique Airbnb stays synchronously (/v1/stays/search)
stays = requests.get(
    "https://api.pindataapi.com/v1/stays/search",
    params={"location": "Paris", "checkin": "2026-12-10", "checkout": "2026-12-12", "adults": 2},
    headers=HEADERS,
    timeout=15,
).json()["data"]["listings"]
print(pins[0]["title"], pins[0]["dominant_color"], stays[0]["nightly_price_usd"])

// BEFORE: await apifyClient.actor("...").call({ search: "mid century interior", maxItems: 20 })
// AFTER: Native fetch() — zero SDK dependencies, <1s response for Next.js / n8n / AI Agents

const API_KEY = process.env.PINDATAAPI_KEY!;
const headers = { Authorization: `Bearer ${API_KEY}` };

// 1. Visual Pin Search -> /v1/pins/search
const searchRes = await fetch(
  "https://api.pindataapi.com/v1/pins/search?query=" +
    encodeURIComponent("mid century interior") +
    "&limit=20",
  { headers },
);
const { data } = await searchRes.json();

// 2. Creator Boards + Boutique Stays in parallel
const [boardsRes, staysRes] = await Promise.all([
  fetch(`https://api.pindataapi.com/v1/boards/search?query=${encodeURIComponent("ceramic studio")}&limit=10`, { headers }),
  fetch(`https://api.pindataapi.com/v1/stays/market?market=Kyoto&limit=10`, { headers }),
]);

const boards = (await boardsRes.json()).data.boards;
const stays = (await staysRes.json()).data.listings;
console.log({ pinsCount: data.pins.length, boardsCount: boards.length, staysCount: stays.length });

# 1. Search Pinterest visual pins (<1s sync JSON — 2 Credits / pin returned)
curl -sS "https://api.pindataapi.com/v1/pins/search?query=ceramic+mug&limit=5" \
  -H "Authorization: Bearer pn_live_YOUR_API_KEY"

# 2. Inspect full Pin metadata & image tiers by pin_id (5 Credits)
curl -sS "https://api.pindataapi.com/v1/pins/details?pin_id=14074436123984512" \
  -H "Authorization: Bearer pn_live_YOUR_API_KEY"

# 3. Search creator aesthetic moodboards (2 Credits / board)
curl -sS "https://api.pindataapi.com/v1/boards/search?query=mid+century+interior&limit=10" \
  -H "Authorization: Bearer pn_live_YOUR_API_KEY"

# 4. Search Airbnb boutique stays with nightly USD pricing & Superhost flags (5 Credits / stay)
curl -sS "https://api.pindataapi.com/v1/stays/search?location=Paris&checkin=2026-12-10&checkout=2026-12-12&adults=2" \
  -H "Authorization: Bearer pn_live_YOUR_API_KEY"

{
  "ok": true,
  "endpoint": "/v1/pins/search",
  "meta": {
    "request_id": "req_pn_sync_mig_84c1e",
    "credits_used": 4,
    "took_ms": 22,
    "cache_hit": true
  },
  "data": {
    "query": "ceramic mug",
    "count": 2,
    "pins": [
      {
        "pin_id": "14074436123984512",
        "title": "Hand-Thrown Speckled Stoneware Espresso Mug",
        "dominant_color": "#D4A373",
        "palette_swatches": ["#D4A373", "#FAF7F5", "#8B5E3C", "#2A9D8F", "#141110"],
        "aspect_ratio": "1080x1620",
        "save_count": 14280,
        "outbound_domain": "etsy.com",
        "outbound_url": "https://www.etsy.com/listing/speckled-stoneware-mug",
        "image_url": "https://i.pinimg.com/originals/92/4a/1c/924a1cc8f12e.jpg"
      }
    ]
  }
}