# Pinterest API
> Real-time Pinterest data as an API — pins, boards and users, returned as clean JSON. Search pins, boards or users by keyword; look up any user's profile with follower, pin and board counts; pull a user's boards and their pins; fetch a pin's details (repins, comments, image, link, domain, pinner) and its related pins; and fetch a board's details and its pins. Live data with titles, descriptions, full-resolution image URLs, outbound links, repin and comment counts, dominant colours and creators. Ideal for social listening and trend research, content aggregation and discovery, e-commerce and visual-marketing tools, and dashboards. 10 data endpoints. Authenticated with an x-oanor-key; fair-use rate limits per plan.

## Authentication
All requests require your oanor API key in the `x-oanor-key` header. Get one at https://www.oanor.com/developer/keys.

```bash
curl -H "x-oanor-key: oanor_live_…" "https://api.oanor.com/pinterest-api/..."
```

## Pricing
- **Free** (Free) — 800 calls/Mo, 3 req/s
- **Starter** ($15/Mo) — 22,000 calls/Mo, 8 req/s
- **Pro** ($49/Mo) — 130,000 calls/Mo, 20 req/s
- **Mega** ($169/Mo) — 700,000 calls/Mo, 45 req/s

## Endpoints

### Search

#### `GET /v1/search/boards` — Search boards

**Parameters:**
- `query` (query, required, string) — Search query Example: `recipes`
- `limit` (query, optional, string) — Max results Example: `25`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/pinterest-api/v1/search/boards?query=recipes&limit=25"
```

**Response:**
```json
{
    "data": {
        "count": 50,
        "query": "recipes",
        "boards": [
            {
                "id": "645633365269360182",
                "url": "https://www.pinterest.com/crazylaurablog/recipes/",
                "name": "Recipes",
                "image": "https://i.pinimg.com/474x/db/1a/2d/db1a2d937d73308546b89551b3ead26f.jpg",
                "owner": {
                    "username": "crazylaurablog",
                    "full_name": "Crazy Laura | Bujo | DIY & Crafts | Home Decor | Recipes"
                },
                "privacy": "public",
                "pin_count": 4358,
                "description": "Whether you're looking for a new instant pot recipe or need inspiration for those cupcakes you're baking for the birthday party...  we have it covered! Check out the best recipes and follow for more ideas!",
                "section_count": 0
            },
            {
                "id": "567735165464352545",
                "url": "https://www.pinterest.com/smrtscholhouse/recipes/",
                "name": "Recipes",
                "image": "https://i.pinimg.com/474x/58/a5/bf/58a5bf417a77ad64402d111fb17a7a06.jpg",
                "owner": {
                    "username": "smrtscholhouse",
                    "full_name": "Smart School House - DIY Crafts and Easy Recipes"
                },
                "privacy": "public",
                "pin_count": 12954,
                "description": "Easy Pinterest Recipes are simple, creativ
…(truncated, see openapi.json for full schema)
```

#### `GET /v1/search/pins` — Search pins

**Parameters:**
- `query` (query, required, string) — Search query Example: `galaxy`
- `limit` (query, optional, string) — Max results (1–50) Example: `25`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/pinterest-api/v1/search/pins?query=galaxy&limit=25"
```

**Response:**
```json
{
    "data": {
        "pins": [
            {
                "id": "1900024838134773",
                "url": "https://www.pinterest.com/pin/1900024838134773/",
                "link": "https://www.pinterest.com/pin/687854543071549380/",
                "board": {
                    "id": "1900093531834996",
                    "url": "/missjuliafaye/nails/",
                    "name": "Nails 💅🏼"
                },
                "image": "https://i.pinimg.com/originals/73/95/55/7395559c4fce054508e021d5c13fa616.jpg",
                "title": "",
                "domain": "pinterest.com",
                "pinner": {
                    "id": "1900162251228482",
                    "username": "missjuliafaye",
                    "full_name": "Julia Van Den Hende"
                },
                "is_video": false,
                "created_at": "Fri, 05 Jul 2024 02:27:48 +0000",
                "description": " ",
                "dominant_color": "#2f3481"
            },
            {
                "id": "703756189320619",
                "url": "https://www.pinterest.com/pin/703756189320619/",
                "board": {
                    "id": "703824880817940",
                    "url": "/darcieg09/psh-i-got-this-diy/",
                    "name": "Psh, I got this! (DIY)"
                },
                "image": "https://i.pinimg.com/originals/92/e5/31/92e53128ecc90c62ff34267b4f7b922f.jpg",
                "title": "galaxy 🌌",
                "domain
…(truncated, see openapi.json for full schema)
```

#### `GET /v1/search/users` — Search users

**Parameters:**
- `query` (query, required, string) — Search query Example: `nasa`
- `limit` (query, optional, string) — Max results Example: `25`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/pinterest-api/v1/search/users?query=nasa&limit=25"
```

**Response:**
```json
{
    "data": {
        "count": 50,
        "query": "nasa",
        "users": [
            {
                "id": "142567281862381039",
                "url": "https://www.pinterest.com/nasa/",
                "image": "https://i.pinimg.com/280x280_RS/37/a1/75/37a175e6d2431425576f0b8f81389394.jpg",
                "username": "nasa",
                "verified": true,
                "full_name": "NASA",
                "pin_count": 10544,
                "board_count": 82,
                "follower_count": 556990
            },
            {
                "id": "861172897404947160",
                "url": "https://www.pinterest.com/ji6ki/",
                "image": "https://i.pinimg.com/280x280_RS/55/fd/b7/55fdb77bc48e4f5e4575540fd188af12.jpg",
                "username": "ji6ki",
                "verified": false,
                "full_name": "nasa",
                "pin_count": 288,
                "board_count": 5,
                "follower_count": 2709
            },
            {
                "id": "681732599751723854",
                "url": "https://www.pinterest.com/nushratnaz0501/",
                "image": "https://i.pinimg.com/280x280_RS/2f/91/14/2f91145a616032c75f2929dde1194bde.jpg",
                "username": "nushratnaz0501",
                "verified": false,
                "full_name": "nushrat naz",
                "pin_count": 659,
                "board_count": 12,
                "follower_count": 34468
            },
            {
              
…(truncated, see openapi.json for full schema)
```

### Users

#### `GET /v1/user` — User profile

**Parameters:**
- `username` (query, required, string) — Pinterest username Example: `nasa`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/pinterest-api/v1/user?username=nasa"
```

**Response:**
```json
{
    "data": {
        "user": {
            "id": "142567281862381039",
            "url": "https://www.pinterest.com/nasa/",
            "about": "Explore the universe and discover our home planet with the official NASA boards on Pinterest. Visit us at www.nasa.gov",
            "image": "https://i.pinimg.com/280x280_RS/37/a1/75/37a175e6d2431425576f0b8f81389394.jpg",
            "website": "http://www.nasa.gov/",
            "username": "nasa",
            "verified": true,
            "full_name": "NASA",
            "pin_count": 10544,
            "board_count": 82,
            "follower_count": 556990,
            "following_count": 5
        }
    },
    "meta": {
        "timestamp": "2026-06-07T16:47:41.834Z",
        "request_id": "5bd1ddb7-3b86-4c2c-86d0-bed072f8d485"
    },
    "status": "ok",
    "message": "User retrieved successfully",
    "success": true
}
```

#### `GET /v1/user/boards` — A user's boards

**Parameters:**
- `username` (query, required, string) — Pinterest username Example: `nasa`
- `limit` (query, optional, string) — Max boards Example: `25`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/pinterest-api/v1/user/boards?username=nasa&limit=25"
```

**Response:**
```json
{
    "data": {
        "count": 25,
        "boards": [
            {
                "id": "142567213143159083",
                "url": "https://www.pinterest.com/nasa/learn-with-nasa/",
                "name": "Learn With NASA",
                "image": "https://i.pinimg.com/474x/bc/4b/d4/bc4bd4150190ef8ac96e9ff6c4f3e806.jpg",
                "owner": {
                    "username": "nasa",
                    "full_name": "NASA"
                },
                "privacy": "public",
                "pin_count": 1616,
                "created_at": "Mon, 05 Dec 2016 19:34:54 +0000",
                "description": "Activities, resources, and opportunities from NASA and its partners that are designed to engage K-12 students in the agency's missions.",
                "section_count": 0,
                "follower_count": 527547
            },
            {
                "id": "142567213143304042",
                "url": "https://www.pinterest.com/nasa/first-woman/",
                "name": "First Woman",
                "image": "https://i.pinimg.com/474x/f2/71/86/f2718619a55e3d61c52bb9e7bb6aed2e.jpg",
                "owner": {
                    "username": "nasa",
                    "full_name": "NASA"
                },
                "privacy": "public",
                "pin_count": 6,
                "created_at": "Mon, 26 Jul 2021 19:35:40 +0000",
                "description": "",
                "section_count": 0,
                "follower_count": 526679
    
…(truncated, see openapi.json for full schema)
```

#### `GET /v1/user/pins` — A user's pins

**Parameters:**
- `username` (query, required, string) — Pinterest username Example: `nasa`
- `limit` (query, optional, string) — Max pins Example: `25`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/pinterest-api/v1/user/pins?username=nasa&limit=25"
```

**Response:**
```json
{
    "data": {
        "pins": [
            {
                "id": "142567144448722388",
                "url": "https://www.pinterest.com/pin/142567144448722388/",
                "link": "https://www.nasa.gov/stem-content/what-comes-next-game/",
                "board": {
                    "id": "142567213143159083",
                    "url": "/nasa/learn-with-nasa/",
                    "name": "Learn With NASA"
                },
                "image": "https://i.pinimg.com/originals/67/e6/ae/67e6ae6e1f4cbbc84854b21e5a85eb96.png",
                "title": "NASA Games: What Comes Next?",
                "domain": "nasa.gov",
                "pinner": {
                    "id": "142567281862381039",
                    "username": "nasa",
                    "full_name": "NASA"
                },
                "is_video": false,
                "created_at": "Mon, 01 Jun 2026 11:35:30 +0000",
                "description": "Students can develop their pattern skills by playing this game correlated to the National Council of Teachers of Mathematics standard: Recognize, describe and extend patterns, such as sequences of sounds and shapes or simple numeric patterns, and translate from one representation to another.",
                "repin_count": 0,
                "comment_count": 0,
                "dominant_color": "#456998"
            },
            {
                "id": "142567144448690562",
                "url": "https://www.pinterest.com/pin/1425671444486
…(truncated, see openapi.json for full schema)
```

### Pins

#### `GET /v1/pin` — Pin details

**Parameters:**
- `id` (query, required, string) — Pin id Example: `142567144448722388`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/pinterest-api/v1/pin?id=142567144448722388"
```

**Response:**
```json
{
    "data": {
        "pin": {
            "id": "142567144448722388",
            "url": "https://www.pinterest.com/pin/142567144448722388/",
            "link": "https://www.nasa.gov/stem-content/what-comes-next-game/",
            "board": {
                "id": "142567213143159083",
                "url": "/nasa/learn-with-nasa/",
                "name": "Learn With NASA"
            },
            "image": "https://i.pinimg.com/originals/67/e6/ae/67e6ae6e1f4cbbc84854b21e5a85eb96.png",
            "title": "NASA Games: What Comes Next?",
            "domain": "nasa.gov",
            "pinner": {
                "id": "142567281862381039",
                "username": "nasa",
                "full_name": "NASA"
            },
            "is_video": false,
            "created_at": "Mon, 01 Jun 2026 11:35:30 +0000",
            "description": "Students can develop their pattern skills by playing this game correlated to the National Council of Teachers of Mathematics standard: Recognize, describe and extend patterns, such as sequences of sounds and shapes or simple numeric patterns, and translate from one representation to another.",
            "repin_count": 0,
            "comment_count": 0,
            "dominant_color": "#456998"
        }
    },
    "meta": {
        "timestamp": "2026-06-07T16:47:52.777Z",
        "request_id": "f34bd1f2-d979-4194-8a7c-bedc316278f8"
    },
    "status": "ok",
    "message": "Pin retrieved successfully",
    "success": true
}
```

#### `GET /v1/pin/related` — Related pins

**Parameters:**
- `id` (query, required, string) — Pin id Example: `142567144448722388`
- `limit` (query, optional, string) — Max pins Example: `25`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/pinterest-api/v1/pin/related?id=142567144448722388&limit=25"
```

**Response:**
```json
{
    "data": {
        "pins": [
            {
                "id": "1114500239061368480",
                "url": "https://www.pinterest.com/pin/1114500239061368480/",
                "board": {
                    "id": "1114500307726955833",
                    "url": "/meeptina/_quick_creates/",
                    "name": "Pins by you"
                },
                "image": "https://i.pinimg.com/originals/56/70/46/567046e6892b6d8eb16f1db247b40fca.jpg",
                "title": "Christina Koch",
                "domain": "Uploaded by user",
                "pinner": {
                    "id": "1114500376444730708",
                    "username": "meeptina",
                    "full_name": "jos"
                },
                "is_video": false,
                "created_at": "Sat, 16 May 2026 23:49:41 +0000",
                "description": "Her side profile omggggg",
                "repin_count": 35,
                "comment_count": 0,
                "dominant_color": "#725546"
            },
            {
                "id": "565061084523320026",
                "url": "https://www.pinterest.com/pin/565061084523320026/",
                "board": {
                    "id": "565061153186062773",
                    "url": "/amartinerro/ideas/",
                    "name": "ideas"
                },
                "image": "https://i.pinimg.com/originals/6c/95/c9/6c95c9f921de77eaf7c687b659048b56.jpg",
                "title": "",
                "domain": "
…(truncated, see openapi.json for full schema)
```

### Boards

#### `GET /v1/board` — Board details

**Parameters:**
- `username` (query, required, string) — Board owner username Example: `nasa`
- `slug` (query, required, string) — Board slug Example: `learn-with-nasa`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/pinterest-api/v1/board?username=nasa&slug=learn-with-nasa"
```

**Response:**
```json
{
    "data": {
        "board": {
            "id": "142567213143159083",
            "url": "https://www.pinterest.com/nasa/learn-with-nasa/",
            "name": "Learn With NASA",
            "owner": {
                "username": "nasa",
                "full_name": "NASA"
            },
            "privacy": "public",
            "pin_count": 1616,
            "description": "Activities, resources, and opportunities from NASA and its partners that are designed to engage K-12 students in the agency's missions.",
            "section_count": 0,
            "follower_count": 527547
        }
    },
    "meta": {
        "timestamp": "2026-06-07T16:47:58.059Z",
        "request_id": "f8df8c41-73aa-44b9-92ca-151442dd191b"
    },
    "status": "ok",
    "message": "Board retrieved successfully",
    "success": true
}
```

#### `GET /v1/board/pins` — A board's pins

**Parameters:**
- `id` (query, required, string) — Board id Example: `142567213143159083`
- `limit` (query, optional, string) — Max pins Example: `25`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/pinterest-api/v1/board/pins?id=142567213143159083&limit=25"
```

**Response:**
```json
{
    "data": {
        "pins": [
            {
                "id": "142567144448722388",
                "url": "https://www.pinterest.com/pin/142567144448722388/",
                "link": "https://www.nasa.gov/stem-content/what-comes-next-game/",
                "board": {
                    "id": "142567213143159083",
                    "url": "/nasa/learn-with-nasa/",
                    "name": "Learn With NASA"
                },
                "image": "https://i.pinimg.com/originals/67/e6/ae/67e6ae6e1f4cbbc84854b21e5a85eb96.png",
                "title": "NASA Games: What Comes Next?",
                "domain": "nasa.gov",
                "pinner": {
                    "id": "142567281862381039",
                    "username": "nasa",
                    "full_name": "NASA"
                },
                "is_video": false,
                "created_at": "Mon, 01 Jun 2026 11:35:30 +0000",
                "description": "Students can develop their pattern skills by playing this game correlated to the National Council of Teachers of Mathematics standard: Recognize, describe and extend patterns, such as sequences of sounds and shapes or simple numeric patterns, and translate from one representation to another.",
                "repin_count": 0,
                "comment_count": 0,
                "dominant_color": "#456998"
            },
            {
                "id": "142567144448690562",
                "url": "https://www.pinterest.com/pin/1425671444486
…(truncated, see openapi.json for full schema)
```

### Meta

#### `GET /v1/meta` — Spec

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/pinterest-api/v1/meta"
```

**Response:**
```json
{
    "data": {
        "service": "pinterest-api",
        "endpoints": {
            "GET /v1/pin": "Pin details by id.",
            "GET /v1/meta": "This document.",
            "GET /v1/user": "User profile by username.",
            "GET /v1/board": "Board details by username + slug.",
            "GET /v1/user/pins": "A user's pins.",
            "GET /v1/board/pins": "A board's pins by board id.",
            "GET /v1/pin/related": "Related pins.",
            "GET /v1/search/pins": "Search pins.",
            "GET /v1/user/boards": "A user's boards.",
            "GET /v1/search/users": "Search users.",
            "GET /v1/search/boards": "Search boards."
        },
        "description": "Pinterest data: search pins/boards/users, pin and board details, board pins, user pins and boards — real live data."
    },
    "meta": {
        "timestamp": "2026-06-07T16:48:15.809Z",
        "request_id": "e4fa2569-e56a-490f-a311-b627b16295b3"
    },
    "status": "ok",
    "message": "Meta",
    "success": true
}
```


---
Marketplace page: https://www.oanor.com/api/pinterest-api
OpenAPI spec: https://www.oanor.com/api/pinterest-api/openapi.json