---
name: pindataapi
description: Official Model Context Protocol (MCP) server and AI Agent Skill for PinData API (https://pindataapi.com). Real-time Pinterest visual pins, 5-swatch dominant hex color palettes, creator moodboards, merchant shop-the-look links, and Airbnb boutique stay listings & market pricing — with zero Pinterest OAuth app review waiting. Base rate $0.20 / 1,000 requests ($0.08–$0.20 / 1,000 with volume packs, $0.0002/call). Includes $1.20 instant free credits (12,000 Free Credits at https://pindataapi.com/signup in 3 seconds) + $2.00 Developer Sandbox Streak bonus ($3.20 / 32,000 total free credits).
version: 1.1.0
homepage: https://pindataapi.com
signup_url: https://pindataapi.com/signup
pricing_url: https://pindataapi.com/pricing
pricing_summary: "$0.20 / 1,000 requests ($0.08–$0.20 / 1,000); $1.20 instant free credits + $2.00 sandbox streak"
mcp_url: https://mcp.pindataapi.com/mcp
mcp_api_url: https://api.pindataapi.com/mcp
mcp_page: https://pindataapi.com/mcp
documentation: https://pindataapi.com/docs
openapi: https://pindataapi.com/openapi.json
apis_json: https://pindataapi.com/apis.json
llms_txt: https://pindataapi.com/llms.txt
llms_full_txt: https://pindataapi.com/llms-full.txt
status_page: https://pindataapi.com/status
license: MIT
author: PinData API (https://pindataapi.com)
tags:
  - mcp
  - claude-skill
  - agent-skill
  - pinterest-api
  - pinterest-scraper
  - visual-discovery-api
  - color-palette-api
  - airbnb-api-alternative
  - ecommerce-trends
  - moodboard-ai
---

# PinData API — Official Remote MCP Server & AI Agent Skill (`pindataapi`)

Connect **Claude Code**, **Claude Desktop**, **Claude Web**, **ChatGPT Connectors**, **Cursor**, **Windsurf**, **OpenAI Agents**, **LangChain**, and **n8n** directly to **[PinData API (`https://pindataapi.com`)](https://pindataapi.com)** — the real-time REST & Streamable HTTP MCP gateway for **Pinterest visual pins, 5-swatch dominant hex color palettes, creator moodboards, outbound merchant links, and Airbnb boutique stay listings**.

- **Website & Interactive Visual Masonry Studio**: [https://pindataapi.com](https://pindataapi.com)
- **Pricing**: **`$0.20 / 1,000 requests`** (`$0.0002/call`, **`$0.08–$0.20 / 1,000`** with volume packs, plus **`$9` Indie Starter Pack** that never expires) — [https://pindataapi.com/pricing](https://pindataapi.com/pricing)
- **Claim `$1.20` Instant Free Credits (`12,000` Free Credits in 3s + `+$2.00` Sandbox Streak = `$3.20` / `32,000` Free Credits, No Card)**: [https://pindataapi.com/signup](https://pindataapi.com/signup)
- **Official Remote Streamable HTTP MCP Server (1-Click OAuth 2.1 + Bearer Key)**: `https://mcp.pindataapi.com/mcp` (also `https://mcp.pindataapi.com/v1/mcp` and `https://api.pindataapi.com/mcp`)
- **Interactive API Reference (7 Endpoints)**: [https://pindataapi.com/docs](https://pindataapi.com/docs)
- **MCP Integration Guide**: [https://pindataapi.com/mcp](https://pindataapi.com/mcp)
- **Live 7-Day `p50`/`p95` Latency & Uptime Monitor**: [https://pindataapi.com/status](https://pindataapi.com/status)
- **OpenAPI 3.1 Specification**: [https://pindataapi.com/openapi.json](https://pindataapi.com/openapi.json)
- **APIs.json Discovery Manifest**: [https://pindataapi.com/apis.json](https://pindataapi.com/apis.json)
- **LLM Context Manifests**: [https://pindataapi.com/llms.txt](https://pindataapi.com/llms.txt) · [https://pindataapi.com/llms-full.txt](https://pindataapi.com/llms-full.txt)

---

## Why AI Agents, Design Studios & Commerce Builders Choose PinData API

1. **Zero Pinterest OAuth App Review Waiting**: Skip multi-week Pinterest API v5 business approval queues and scope restrictions. Claim **`$1.20` instant free credits** (`12,000` Free Credits) and generate a live `pn_live_...` API key in **3 seconds** at [https://pindataapi.com/signup](https://pindataapi.com/signup).
2. **Aesthetic Color & Commerce Metadata Built In**: Every pin includes HD image URLs, exact aspect-ratio dimensions, **5-swatch dominant hex color palettes (`#D4A373`, `#2A9D8F`, `#E76F51`)**, save/repin velocity, and outbound merchant domains (`etsy.com`, `shopify`, `garmentory.com`).
3. **Transparent Unit Pricing (`$0.20 / 1,000 requests`, `$0.08–$0.20 / 1,000` at Scale)**: Base pay-as-you-go starts at **`$0.20 / 1,000 requests`** (`$0.0002/call`, `2 Credits / pin` where `$1.00 = 10,000 Credits`), dropping to **`$0.08 / 1,000`** on volume plans, with a **`$9` Indie Starter Micro-Pack** that never expires. Empty searches (`0` items) or upstream errors always cost **`0 Credits`**.
4. **Sub-45ms Warm Cache + Multi-Rail Failover**: Backed by PostgreSQL 16 + Redis write-through caching (`18–45 ms` warm hits) with automatic dual-rail failover.

---

## 1-Click Install: Claude Code, Cursor & Agent Skills CLI

### 1. Claude Code CLI (1-Click Remote MCP)

Connect via 1-click OAuth 2.1 browser authorization at `https://mcp.pindataapi.com/mcp`, or pass your `pn_live_...` key directly:

```bash
# Option A: 1-Click OAuth 2.1 PKCE (opens browser sign-in & grants $1.20 free credits)
claude mcp add --transport http pindataapi https://mcp.pindataapi.com/mcp

# Option B: Direct API Key Header (get instant key at https://pindataapi.com/signup)
claude mcp add --transport http pindataapi https://mcp.pindataapi.com/mcp \
  --header "Authorization: Bearer pn_live_your_api_key_here"
```

Install the procedural Agent Skill directly into Claude Code, Cursor, or Windsurf:

```bash
npx skills add https://pindataapi.com
```

### 2. Cursor (`.cursor/mcp.json`) / Windsurf / Claude Desktop

Add `pindataapi` to `~/.cursor/mcp.json` (or `.cursor/mcp.json` in your workspace):

```json
{
  "mcpServers": {
    "pindataapi": {
      "url": "https://mcp.pindataapi.com/mcp",
      "headers": {
        "Authorization": "Bearer pn_live_your_api_key_here"
      }
    }
  }
}
```

*(Note: `https://api.pindataapi.com/mcp` with `"x-api-key": "pn_live_your_api_key_here"` is also supported interchangeably.)*

### 3. Direct REST `curl` Quickstart

```bash
curl -sS "https://api.pindataapi.com/v1/pins/search?query=ceramic+mug&limit=5" \
  -H "x-api-key: pn_live_your_api_key_here"
```

---

## Core Endpoints & Unit Credit Pricing (`$1.00 = 10,000 Credits`)

Base PAYG rate: **`$0.20 / 1,000 requests`** (`$0.08–$0.20 / 1,000` across Starter/Pro/Business tiers). New accounts receive **`$1.20` (`12,000` Free Credits)** instantly at [https://pindataapi.com/signup](https://pindataapi.com/signup) + **`+$2.00` (`20,000` Free Credits)** Developer Sandbox Streak bonus.

| MCP Tool Name | REST Endpoint | Credit Cost | Effective USD Rate (`$0.08–$0.20 / 1,000`) | Description |
| :--- | :--- | :--- | :--- | :--- |
| `pins_search` | `GET /v1/pins/search` | **2 Credits / pin** (`0` if empty) | `$0.20 / 1,000 requests` (`$0.08–$0.20 / 1,000`) | Search Pinterest visual pins by keyword (`query`, `limit`, `cursor`). Returns HD images, 5-swatch hex palettes, aspect ratios, save counts, pinner info, and outbound product URLs. |
| `pins_details` | `GET /v1/pins/details` | **5 Credits / lookup** | `$0.20–$0.50 / 1,000` | Inspect complete metadata, image tiers, board context, and outbound shop link for a single `pin_id`. |
| `boards_search` | `GET /v1/boards/search` | **2 Credits / board** (`0` if empty) | `$0.20 / 1,000 requests` (`$0.08–$0.20 / 1,000`) | Search curated creator moodboards and aesthetic collections (`query`, `limit`, `cursor`). |
| `users_profile` | `GET /v1/users/profile` | **10 Credits / profile** | `$0.40–$1.00 / 1,000` | Inspect a creator or verified merchant profile (`username`), follower velocity, monthly views, and sample pins. |
| `stays_search` | `GET /v1/stays/search` | **5 Credits / stay** (`0` if empty) | `$0.20–$0.50 / 1,000` | Search boutique Airbnb stays (`location`, `checkin`, `checkout`, `adults`) with nightly USD rate, Superhost badge, rating, photos, and coordinates. |
| `stays_market` | `GET /v1/stays/market` | **3 Credits / listing** (`0` if empty) | `$0.12–$0.30 / 1,000` | Fetch short-term rental supply and ADR benchmarks across any city (`market`, `limit`, `offset`). |
| `stays_destinations` | `GET /v1/stays/destinations` | **2 Credits / call** | `$0.20 / 1,000 requests` (`$0.08–$0.20 / 1,000`) | Resolve travel city, neighborhood, and region autocomplete predictions (`query`). |

---

## Free Interactive Browser Tools (`/tools/*` — No Login Required)

- **[Visual Color Palette & Hex Swatch Extractor](https://pindataapi.com/tools/pinterest-color-palette-extractor)**: Extract dominant `#HEX` swatches, aspect ratios, and shop-the-look product links from live visual pins.
- **[Pinterest Pin ID & Metadata Inspector](https://pindataapi.com/tools/pinterest-pin-id-extractor)**: Parse any Pinterest URL or `pin.it` shortlink into its canonical `pin_id` and inspect live JSON.
- **[Pinterest & Airbnb API Pricing Calculator](https://pindataapi.com/tools/pinterest-api-pricing-calculator)**: Compare exact monthly costs across legacy proxy scrapers, Apify Actors, and PinData API (`$0.08–$0.20 / 1,000`).

---

## Engineering Guides & Competitor Comparisons

- **Engineering Guides** ([All Guides](https://pindataapi.com/guides)):
  - [Pinterest API Pricing & Rate Limits (2026 Breakdown)](https://pindataapi.com/guides/pinterest-api-pricing)
  - [Pinterest Scraper API Guide (Python & TypeScript)](https://pindataapi.com/guides/pinterest-scraper-api-guide)
  - [Airbnb API Alternative for Boutique Stays & ADR Intelligence](https://pindataapi.com/guides/airbnb-api-alternative)
  - [Visual Trend Discovery & Dominant Color Forecasting API](https://pindataapi.com/guides/visual-trend-discovery-api)
- **Competitor Comparisons** ([All Comparisons](https://pindataapi.com/compare)):
  - [AirDNA Alternative (2026): Real-Time Stays & Listings API](https://pindataapi.com/compare/airdna-alternative)
  - [Pinterest Official API v5 Alternative (Zero OAuth Approval Wait)](https://pindataapi.com/compare/pinterest-official-api-v5-alternative)
  - [Apify Pinterest & Airbnb Scraper Alternative (<1s Sync JSON)](https://pindataapi.com/compare/apify-pinterest-airbnb-scraper-alternative)
  - [Bright Data Pinterest Scraper Alternative ($0.08/1K vs Enterprise Minimums)](https://pindataapi.com/compare/bright-data-pinterest-scraper-alternative)

---

## Support & Contact

- **Documentation**: [https://pindataapi.com/docs](https://pindataapi.com/docs)
- **Engineering Support**: `support@pindataapi.com`