Search curated Pinterest moodboards & aesthetic collections

Parameters

• querystringrequired

  Moodboard or collection keyword (also accepts q).

• limitinteger (1 to 50)

  Maximum boards to return (1–50, default 20).

• cursorstring

  Pagination cursor from data.next_cursor.

Example Request (cURL / Python / JavaScript)

curl "https://api.pindataapi.com/v1/boards/search?query=" \
  -H "x-api-key: pn_live_your_api_key"

import requests

res = requests.get(
    "https://api.pindataapi.com/v1/boards/search?query=",
    headers={"x-api-key": "pn_live_your_api_key"},
    timeout=30,
)
print(res.json())

const res = await fetch("https://api.pindataapi.com/v1/boards/search?query=", {
  headers: { "x-api-key": "pn_live_your_api_key" },
});
const data = await res.json();
console.log(data);

Live Response Preview

{
  "code": 0,
  "provider": "https://pindataapi.com",
  "status": "ok",
  "msg": "success",
  "data": {
    "query": "mid century interior",
    "count": 2,
    "next_cursor": "b281MHwxNTgwNjgzODE4ODk1MjEwKkdRTCp8ZmM4ZWM5YjM2MDg4NzNkZWMzY2E0ZjQwZmQ1MTFiY2IwZjMxYmYyMmFiZGFjNjBkN2U5MjAyM2YzYjBlYTMxN3xORVd8",
    "boards": [
      {
        "board_id": "237916861503727168",
        "name": "Mid Century Interiors",
        "description": null,
        "url": "https://www.pinterest.com/jared1964/mid-century-interiors/",
        "pin_count": 1018,
        "follower_count": 0,
        "section_count": 0,
        "collaborator_count": 0,
        "is_collaborative": false,
        "cover_image_url": "https://i.pinimg.com/474x/91/23/ac/9123ac9493190e09e40ff8b9f254cc42.jpg",
        "sample_thumbnails": [
          "https://i.pinimg.com/150x150/e2/c3/1d/e2c31dcb7c7fbf45cc907c9023c06428.jpg",
          "https://i.pinimg.com/150x150/8c/6d/b6/8c6db6db1efe5ee410a3135ec6f04e72.jpg",
          "https://i.pinimg.com/150x150/08/bc/fc/08bcfc4678e5b9347320d1a979779cf4.jpg",
          "https://i.pinimg.com/150x150/bc/85/0a/bc850a6058d655e3805db0001ab44d7e.jpg",
          "https://i.pinimg.com/150x150/5d/73/ef/5d73ef72f766a6a311348385e3c03ffe.jpg"
        ],
        "palette_hex": [
          "#D4A373",
          "#F0B985",
          "#B2875B",
          "#C6BB93"
        ],
        "owner": {
          "username": "jared1964",
          "full_name": "Jared Neisler",
          "verified_merchant": false,
          "avatar_url": "https://i.pinimg.com/75x75_RS/4a/f4/b4/4af4b4877372e2decf36de5bcee7f4a4.jpg"
        },
        "updated_at": "Thu, 12 Nov 2026 04:14:31 +0000",
        "search_query": "mid century interior"
      },
      {
        "board_id": "161496405327035782",
        "name": "Mid-Century Interior Design",
        "description": "Mid Century modern kitchens, living rooms, and interiors.",
        "url": "https://www.pinterest.com/light_factory/mid-century-interior-design/",
        "pin_count": 348,
        "follower_count": 0,
        "section_count": 0,
        "collaborator_count": 0,
        "is_collaborative": false,
        "cover_image_url": "https://i.pinimg.com/474x/67/65/f0/6765f0af9a4c1856f62f4eab1124875e.jpg",
        "sample_thumbnails": [
          "https://i.pinimg.com/150x150/f6/b4/79/f6b47935ee1d10089ebfe987e95728ae.jpg",
          "https://i.pinimg.com/150x150/56/6b/ed/566bed70afa0e6bb63213f668df47e7e.jpg",
          "https://i.pinimg.com/150x150/69/2b/02/692b02557edc3708e4c41282a1477d0a.jpg",
          "https://i.pinimg.com/150x150/3c/9b/92/3c9b92431947181f9736423ee6da6d3e.jpg",
          "https://i.pinimg.com/150x150/f0/56/1d/f0561d9a6db5b42accfd25592dfbab80.jpg"
        ],
        "palette_hex": [
          "#D4A373",
          "#F0B985",
          "#B2875B",
          "#C6BB93"
        ],
        "owner": {
          "username": "light_factory",
          "full_name": "The Light Factory | Bubble Chandelier Lighting & Light Fixtures",
          "verified_merchant": true,
          "avatar_url": "https://i.pinimg.com/75x75_RS/80/86/4d/80864d8da01504939c50c028155140c8.jpg"
        },
        "updated_at": "Thu, 12 Nov 2026 05:39:57 +0000",
        "search_query": "mid century interior"
      }
    ]
  },
  "meta": {
    "request_id": "5af799fe-5840-4fd7-97f9-05055597e028",
    "endpoint": "/v1/boards/search",
    "credits_charged": 4,
    "cached": false,
    "took_ms": 1916
  }
}

Response Fields

Status Codes

200

Normalized Pinterest moodboard list.

401