Name: Pinterest Pins API: Boards, Profiles and Search
Brand: benthepythondev
SKU: api-benthepythondev-pinterest-pins-boards
Availability: InStock
Author: API Market

# Pinterest Pins API

## Overview

The Pinterest Pins API returns public Pinterest pins as JSON from boards, profiles, single pins and keyword searches. Each pin has its title, description, link, image and video URLs, size, creation date and save count, and optional details add comments, shares and the pin's creator.

It is built for marketers, content teams, ecommerce brands and researchers who track trends, competitors or their own boards on Pinterest. No Pinterest login or account is needed.

## Features

*   **Boards, profiles, pins and search**: one endpoint for all four.
*   **Pin data**: title, description, link, image and video URLs and save counts.
*   **Details**: `includeDetails` adds comments, shares, repins and the creator.
*   **Up to 20 rows per call**: fast synchronous responses.
*   **Rate limit**: up to 10 requests per second on every plan.

## Use Cases

*   **Trend research**: see which pins rank for a keyword.
*   **Competitor tracking**: follow a brand's boards and profile.
*   **Content planning**: collect ideas for a topic.
*   **Ecommerce**: find pins that link to your products.

## API Documentation

### Base URL

All requests go through the API.market proxy at this base URL:

```
https://prod.api.market/api/v1/benthepythondev/pinterest-pins-boards
```

### Authentication

Every request must include your API.market key in the `x-api-market-key` header:

```
x-api-market-key: YOUR_API_KEY
```

Replace `YOUR_API_KEY` with your actual API key.

### Endpoints

#### 1. Board, profile or pin

Returns the pins of each board, profile or pin link you send.

**Method:** `POST`

**Endpoint:** `/`

**Parameters:**

| Name | In | Description | Type | Required | Default | Max Value |
|---|---|---|---|---|---|---|
| boardUrls | body | Pinterest links: a board (pinterest.com/user/board/) returns the board's pins, a profile (pinterest.com/user/) every pin of that profile, a pin link that one pin with its counts, a search link the pins of that search. | array of objects | No | - | - |
| urls | body | Further board, profile, pin or search links as plain text, or bare usernames such as "nasa" for a profile's pins. | array of strings | No | - | - |
| maxResultsPerBoard | body | Pins to save for each board, profile and search, up to 10,000. A request returns 20 rows at most. | integer | No | 20 | 20 |
| includeDetails | body | Reads each pin's own record as well: number of saves, comments, shares and repins, the full description and the pin's first creator. One more request per pin. Board pins already carry saves and repins without it. | boolean | No | false | - |

**Example Request:**

```bash
curl -X POST 'https://prod.api.market/api/v1/benthepythondev/pinterest-pins-boards/' \
  -H 'x-api-market-key: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
  "boardUrls": [
    {
      "url": "https://www.pinterest.com/suma5048/python/"
    }
  ],
  "maxResultsPerBoard": 3
}'
```

**Example Response (200 OK):**

```json
[
  {
    "id": "e1_AfqPShwMHKFkukAb3Z2VQjbrjGLO0odK40H2z_zbDw7qIxtrKcfp",
    "url": "https://www.pinterest.com/pin/e1_AfqPShwMHKFkukAb3Z2VQjbrjGLO0odK40H2z_zbDw7qIxtrKcfp/",
    "title": "Python Notes for Beginners (Easy + Quick Guide)",
    "description": "Learn Python easily with simple and short notes 🐍    ✔ Variables & data types   ✔ Loops & conditions   ✔ Functions basics    Perfect for beginners and students 💻   Save this pin for quick revision 📌    #Python #CodingForBeginners #StudyNote...",
    "destination_url": null,
    "domain": "Uploaded by user",
    "image_url": "https://i.pinimg.com/originals/02/02/4f/02024fa6d44c91bda8214773f9af2495.jpg",
    "image_width": 1079,
    "image_height": 1610,
    "is_video": false,
    "video_url": null,
    "created_at": null,
    "save_count": 1862,
    "reaction_counts": {
      "1": 239
    },
    "creator_id": "959548401765365561",
    "creator_username": "bca_notes_hub",
    "creator_name": "Bca note hub",
    "creator_profile_url": "https://www.pinterest.com/bca_notes_hub/",
    "board_id": "803400089716751612",
    "board_name": "PYTHON",
    "board_url": "https://www.pinterest.com/suma5048/python/",
    "board_description": "Oct 31, 2026 - Explore Suma's board \"PYTHON\" on Pinterest. See more ideas about python, data science, data science learning.",
    "board_privacy": "public",
    "board_pin_count": 941,
    "board_follower_count": 50,
    "board_collaborator_count": 0,
    "board_section_count": 0,
    "board_created_at": null,
    "board_modified_at": "Sat, 31 Oct 2026 16:01:54 +0000",
    "board_cover_image_url": "https://i.pinimg.com/200x150/d6/84/b6/d684b64623b4f0dee69fcc123a28457b.jpg",
    "owner_id": "803400158434829297",
    "owner_username": "suma5048",
    "owner_name": "Suma",
    "owner_followers": null,
    "owner_profile_url": "https://www.pinterest.com/suma5048/",
    "created_at_iso": null,
    "repin_count": 0,
    "comment_count": null,
    "share_count": null,
    "alt_text": "a poster with the words python notes for beginners",
    "dominant_color": "#fcfbfb",
    "creator_followers": null,
    "pinner_username": "suma5048",
    "source": "board:suma5048/python",
    "rank": 1,
    "scraped_at": "2026-11-06T05:53:44.691149+00:00"
  },
  {
    "id": "e1_AfqPShxtp5fR5G24RQFGFYaKBqSshenmeeQLHgeonD6reDnUzK4g",
    "url": "https://www.pinterest.com/pin/e1_AfqPShxtp5fR5G24RQFGFYaKBqSshenmeeQLHgeonD6reDnUzK4g/",
    "title": "a poster with words and pictures on it that say keywordss, python programming",
    "description": null,
    "destination_url": null,
    "domain": "Uploaded by user",
    "image_url": "https://i.pinimg.com/originals/f6/b4/da/f6b4da56cfa3996ec25f047ff3850db7.png",
    "image_width": 1024,
    "image_height": 1536,
    "is_video": false,
    "video_url": null,
    "created_at": null,
    "save_count": 387,
    "reaction_counts": {
      "1": 28
    },
    "creator_id": "1078119735704562608",
    "creator_username": "aw_junaid",
    "creator_name": "Abdul Wahab Junaid",
    "creator_profile_url": "https://www.pinterest.com/aw_junaid/",
    "board_id": "803400089716751612",
    "board_name": "PYTHON",
    "board_url": "https://www.pinterest.com/suma5048/python/",
    "board_description": "Oct 31, 2026 - Explore Suma's board \"PYTHON\" on Pinterest. See more ideas about python, data science, data science learning.",
    "board_privacy": "public",
    "board_pin_count": 941,
    "board_follower_count": 50,
    "board_collaborator_count": 0,
    "board_section_count": 0,
    "board_created_at": null,
    "board_modified_at": "Sat, 31 Oct 2026 16:01:54 +0000",
    "board_cover_image_url": "https://i.pinimg.com/200x150/d6/84/b6/d684b64623b4f0dee69fcc123a28457b.jpg",
    "owner_id": "803400158434829297",
    "owner_username": "suma5048",
    "owner_name": "Suma",
    "owner_followers": null,
    "owner_profile_url": "https://www.pinterest.com/suma5048/",
    "created_at_iso": null,
    "repin_count": 0,
    "comment_count": null,
    "share_count": null,
    "alt_text": "a poster with words and pictures on it that say keywordss, python programming",
    "dominant_color": "#fdfdfd",
    "creator_followers": null,
    "pinner_username": "suma5048",
    "source": "board:suma5048/python",
    "rank": 2,
    "scraped_at": "2026-11-06T05:53:44.691149+00:00"
  }
]
```

#### 2. Keyword search

Returns pins that match each search query.

**Method:** `POST`

**Endpoint:** `/`

**Parameters:**

| Name | In | Description | Type | Required | Default | Max Value |
|---|---|---|---|---|---|---|
| queries | body | Keywords to search Pinterest for, for example "home office ideas". Each query returns pins up to the limit below; Pinterest ends a search after about 900 pins. | array of strings | No | - | - |
| maxResultsPerBoard | body | Pins to save for each board, profile and search, up to 10,000. A request returns 20 rows at most. | integer | No | 20 | 20 |
| includeDetails | body | Reads each pin's own record as well: number of saves, comments, shares and repins, the full description and the pin's first creator. One more request per pin. Board pins already carry saves and repins without it. | boolean | No | false | - |

**Example Request:**

```bash
curl -X POST 'https://prod.api.market/api/v1/benthepythondev/pinterest-pins-boards/' \
  -H 'x-api-market-key: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
  "queries": [
    "home office ideas"
  ],
  "maxResultsPerBoard": 3
}'
```

**Example Response (200 OK):**

```json
[
  {
    "id": "e1_AfqPShyfxuRvkSfnnmyWSssKjPAwQ5Y5m83-hnsQW8k94ieM_CNauQ",
    "url": "https://www.pinterest.com/pin/e1_AfqPShyfxuRvkSfnnmyWSssKjPAwQ5Y5m83-hnsQW8k94ieM_CNauQ/",
    "title": "Cozy Home Office Ideas with Built-In Shelves & Neutral Decor",
    "description": "Get inspired by these cozy small home office ideas with a wood desk, built in shelves, and neutral home office decor. A brown leather chair, warm lighting, and woven textures make this workspace feel inviting. Save this home office design f...",
    "destination_url": null,
    "domain": "Uploaded by user",
    "image_url": "https://i.pinimg.com/originals/14/f9/2f/14f92ff4daebc1a0a40783433a774488.jpg",
    "image_width": 1024,
    "image_height": 1536,
    "is_video": false,
    "video_url": null,
    "created_at": "Thu, 29 Oct 2026 15:50:13 +0000",
    "save_count": null,
    "reaction_counts": {},
    "creator_id": "1106689445841111204",
    "creator_username": "decorbrief",
    "creator_name": "Decor Brief | Home Decor, Interior & Styling Ideas",
    "creator_profile_url": "https://www.pinterest.com/decorbrief/",
    "board_id": "1106689377123651620",
    "board_name": "Pins by you",
    "board_url": "https://www.pinterest.com/decorbrief/_quick_creates/",
    "board_description": null,
    "board_privacy": null,
    "board_pin_count": 196,
    "board_follower_count": null,
    "board_collaborator_count": 0,
    "board_section_count": 0,
    "board_created_at": null,
    "board_modified_at": "Tue, 04 Aug 2026 23:11:22 +0000",
    "board_cover_image_url": "https://i.pinimg.com/150x150/15/96/85/159685fb4ce1eeceda9b424db16c0229.jpg",
    "owner_id": "1106689445841111204",
    "owner_username": "decorbrief",
    "owner_name": "Decor Brief | Home Decor, Interior & Styling Ideas",
    "owner_followers": 18,
    "owner_profile_url": "https://www.pinterest.com/decorbrief/",
    "created_at_iso": "2026-10-29T15:50:13+00:00",
    "repin_count": null,
    "comment_count": null,
    "share_count": null,
    "alt_text": "Small home office with a wooden desk, brown leather chair, taupe built-in shelves, a laptop, black lamp, woven window shade, and a textured beige rug.",
    "dominant_color": "#705a4b",
    "creator_followers": 18,
    "pinner_username": "decorbrief",
    "source": "search:home office ideas",
    "rank": 1,
    "scraped_at": "2026-11-06T05:53:52.018244+00:00"
  },
  {
    "id": "e1_AfqPShxHe55oRml01w0-thb7D-832G1W7PCLoh2e8WknS-uVRBAFKw",
    "url": "https://www.pinterest.com/pin/e1_AfqPShxHe55oRml01w0-thb7D-832G1W7PCLoh2e8WknS-uVRBAFKw/",
    "title": "Lush Green Calming Office Decor",
    "description": "I love how this lush home office turns greenery into the main design feature... The deep green walls, wooden desk, and abundant plants create a cozy atmosphere that feels rich, grounded, and connected to nature.\nThis style is perfect for an...",
    "destination_url": null,
    "domain": "Uploaded by user",
    "image_url": "https://i.pinimg.com/originals/9b/1f/92/9b1f9232e7ec0092e86c529711c1ebf3.jpg",
    "image_width": 1152,
    "image_height": 1728,
    "is_video": false,
    "video_url": null,
    "created_at": "Wed, 28 Oct 2026 10:02:19 +0000",
    "save_count": null,
    "reaction_counts": {},
    "creator_id": "1134414731046974220",
    "creator_username": "MyMindfulHomeIdeas",
    "creator_name": "My Mindful Home | Calming Paint Colors & Relaxing Interior Design",
    "creator_profile_url": "https://www.pinterest.com/MyMindfulHomeIdeas/",
    "board_id": "1134414662329424877",
    "board_name": "Calming Office Decor",
    "board_url": "https://www.pinterest.com/MyMindfulHomeIdeas/calming-office-decor/",
    "board_description": null,
    "board_privacy": null,
    "board_pin_count": 57,
    "board_follower_count": null,
    "board_collaborator_count": 0,
    "board_section_count": 0,
    "board_created_at": null,
    "board_modified_at": "Thu, 05 Nov 2026 20:31:30 +0000",
    "board_cover_image_url": "https://i.pinimg.com/474x/63/3d/36/633d364ef40708aa2eb94df16ccec379.jpg",
    "owner_id": "1134414731046974220",
    "owner_username": "MyMindfulHomeIdeas",
    "owner_name": "My Mindful Home | Calming Paint Colors & Relaxing Interior Design",
    "owner_followers": 3,
    "owner_profile_url": "https://www.pinterest.com/MyMindfulHomeIdeas/",
    "created_at_iso": "2026-10-28T10:02:19+00:00",
    "repin_count": null,
    "comment_count": null,
    "share_count": null,
    "alt_text": "Lush green home office with dark green walls, wooden desk, numerous indoor plants, bookshelves, and natural light.",
    "dominant_color": "#594f34",
    "creator_followers": 3,
    "pinner_username": "MyMindfulHomeIdeas",
    "source": "search:home office ideas",
    "rank": 2,
    "scraped_at": "2026-11-06T05:53:52.018244+00:00"
  }
]
```

## Status Codes

| Code | Status | Description |
|---|---|---|
| 200 | OK | The request succeeded and the response body holds the result. |
| 400 | Bad Request | A required parameter is missing or a value is invalid. Check the parameter table for the endpoint. |
| 401 | Unauthorized | The `x-api-market-key` header is missing or the key is not valid. |
| 403 | Forbidden | Your key is valid but your subscription does not allow this request, for example an endpoint outside your plan. |
| 404 | Not Found | The path does not exist, or the resource you asked for was not found. |
| 429 | Too Many Requests | You sent more than 10 requests per second. Slow down and retry, honouring the `Retry-After` header. |
| 500 | Internal Server Error | Something went wrong while processing the request. Retry after a short wait. |
| 503 | Service Unavailable | The service or its upstream data source is temporarily unavailable. Retry with backoff. |

## Rate Limits

Every plan allows up to 10 requests per second. Subscription plans also have a monthly call quota shown on the pricing page. Sending more than 10 requests per second returns `429 Too Many Requests`. Throttle your client to stay under 10 requests per second, back off and retry when you get a 429, and honour the `Retry-After` header when it is present.

## FAQ

*   **Which links can I send?**

    Board links, profile links, single pin links, or bare usernames such as `nasa` in `urls`.

*   **Do I need a Pinterest account?**

    No. It reads public pins only.

*   **How many results does one call return?**

    Up to 20 rows per call. Send another call with other input for more.

*   **How long does a call take?**

    Usually 3 to 10 seconds, and at most 60 seconds.

## Contact Us

If you have any questions or need assistance, you can reach out to us through the embedded chat on the bottom right corner of the page or send an email to hello@magicapi.com.


Get public Pinterest pins from boards, profiles, pin links and keyword searches as JSON, with images, links and save counts.