Pinterest API

Pinterest API for pin search, boards and images

Public Pinterest pins as JSON: search pins or videos by keyword, list a board's pins, read profiles and their boards, with the original image, outbound link and creation date. No app review.

  • No card needed
  • Failed calls are free
  • Pack credits never expire
Keyword
Endpoint
curl "https://api.toolzerhub.com/v1/pinterest/search/pins?query=kitchen+ideas" \
  -H "x-api-key: $TOOLZERHUB_API_KEY"
200 OK
Real response, 22 Oct 2026
{
  "data": {
    "results": [
      {
        "id": "e1_AfqPShz3R431sNW1uDn-eJrr22p4ZLWBaUku450zFRi3SJcINS-rdw",
        "type": "pin",
        "title": "Cozy Modern Farmhouse Kitchen Ideas",
        "description": "Create a warm and inviting kitchen with elegant sage-green cabinets, glowing glass-front storage, beautiful marble countertops, natural wood accents, and cha...",
        "link": null,
        "domain": "Uploaded by user",
        "created_at": "Thu, 01 Oct 2026 05:48:30 +0000",
        "reaction_counts": {
          "1": 13
        },
        "auto_alt_text": "a kitchen filled with lots of green cabinets and counter top space next to a window",
        "images": {
          "orig": {
            "width": 672,
            "height": 795,
            "url": "https://i.pinimg.com/originals/69/06/60/690660fb8a0f21dfdf4aaa54d3223e1e.jpg"
          }
        },
        "videos": null,
        "pinner": {
          "username": "…",
          "follower_count": 51
        },
        "board": {
          "id": "1109293020658371701",
          "name": "cozy kitchen home decor",
          "url": "/…/cozy-kitchen-home-decor/"
        }
      },
      {
        "id": "e1_AfqPShzEznX4GitX2kx2fgvrqMTDXICE5V-spyPZXjgB-mKysqVx",
        "type": "pin",
        "title": "",
        "description": " ",
        "link": null,
        "domain": "Uploaded by user",
        "created_at": "Fri, 09 Oct 2026 09:33:01 +0000",
        "reaction_counts": {
          "1": 2
        },
        "auto_alt_text": "a kitchen filled with lots of counter top space",
        "images": {
          "orig": {
            "width": 1198,
            "height": 1313,
            "url": "https://i.pinimg.com/originals/7f/fb/24/7ffb240ed18d8939378088ceaf8226c9.jpg"
          }
        },
        "videos": null,
        "pinner": {
          "username": "…",
          "follower_count": 34
        },
        "board": {
          "id": "456411812176433165",
          "name": "Hus inspo front interiør",
          "url": "/…/hus-inspo-front-interi%C3%B8r/"
        }
      },
      {
        "id": "e1_AfqPShwHCT9LLs7Puvd82xCQeuGGoId7s4Zm8gpxG2aYnv_8T79wFA",
        "type": "pin",
        "title": "8 Modern Small Kitchen Decor Tips for a Sleek, Space-Saving Style and Functionality",
        "description": "(Paid Link) 🤩 Discover 8 modern small kitchen decor tips that blend sleek style with smart functionality. Learn space-saving layouts, compact storage ideas,...",
        "link": "https://www.amazon.com/Latest-Modern-Small-Kitchen-Decor-20260925053700/s?k=modern+kitchen+decor&tag=…",
        "domain": "amazon.com",
        "created_at": "Sat, 26 Sep 2026 22:48:54 +0000",
        "reaction_counts": {
          "1": 1
        },
        "auto_alt_text": "two wooden stools sit in front of an island with white counter tops and wood paneling",
        "images": {
          "orig": {
            "width": 1000,
            "height": 1500,
            "url": "https://i.pinimg.com/originals/78/5b/f0/785bf018160d26f51a515dfa8165524b.jpg"
          }
        },
        "videos": null,
        "pinner": {
          "username": "…",
          "follower_count": 116
        },
        "board": {
          "id": "1100004346426348499",
          "name": "Modern Small Kitchen Decor",
          "url": "/…/modern-small-kitchen-decor/"
        }
      }
    ],
    "bookmark": "Y2JVSG81V2sxcmNHRlpWM1J5VFVad1ZsWlVWbFJX..."
  }
}

3 of 18 pins shown, trimmed to the main fields; creator names removed.

1
1 credit per call
99%
finished without a server error
0.9 s
median response time
5
Pinterest endpoints

From our request logs, last 30 days to 22 Oct 2026; mostly our own tests.

Response

What comes back

Field names and types read off the real responses in the demo above.

  • Search pins/v1/pinterest/search/pins13 fields
    • idstring"e1_AfqPShz3R431sNW1uDn-…"
    • typestring"pin"
    • titlestring"Cozy Modern Farmhouse K…"
    • descriptionstring"Create a warm and invit…"
    • linknullnull
    • domainstring"Uploaded by user"
    • created_atstring"Thu, 01 Oct 2026 05:48:…"
    • reaction_countsobject{ 1 }
    • auto_alt_textstring"a kitchen filled with l…"
    + 4 more
  • Board pins/v1/pinterest/boards/pins13 fields
    • idstring"e1_AfqPShz3R431sNW1uDn-…"
    • typestring"pin"
    • titlestring"Cozy Modern Farmhouse K…"
    • descriptionstring"Create a warm and invit…"
    • linknullnull
    • domainstring"Uploaded by user"
    • created_atnullnull
    • reaction_countsobject{ 1 }
    • auto_alt_textstring"a kitchen filled with l…"
    + 4 more

Use cases

What people build with it

  • 01Find what gets pinned for a topicSearch pins
  • 02Collect reference images for a keywordSearch pinsBoard pins
  • 03Read a creator's boards and pinsProfileProfile boardsBoard pins

How it works

From key to JSON

  1. 01x-api-key••••••••••Get a key100 free credits a month, no card
  2. 02GET/v1/pinterest/search/pinsSend a requestAny HTTP client, no SDK needed
  3. 03{ data, status }200Get JSONFailed calls cost nothing

Pricing

What it costs

Every endpoint on this page costs 1 credit per call. Failed calls cost nothing.

  • Free$0every month
    • 100 credits a month
    • No card needed
  • 10K pack$19one time
    • 10,000 credits
    • Never expire
    • $1.90 per 1,000
  • Starter$29a month
    • 20,000 credits a month
    • Cancel anytime
    • $1.45 per 1,000

Per 1,000 credits

  • 10K pack$1.90
  • Starter$1.45
  • Growth$1.32
  • Scale$1.21
  • Business$0.99
  • Customfrom $0.99

Plans renew monthly and cancel anytime. Custom plans start at 1M+ credits. Full pricing

Compare

Why not build it yourself

Three ways to get Pinterest data into your app.

CompareToolzer HubPinterest API v5Your own scraper
SetupOne API keyApp review, OAuthProxies, sessions, retries
When Pinterest changesWe fix itPinterest keeps it workingYou fix the parser
Cost to start100 free credits a monthPublic pin search in betaProxies and your time

Official API access rules: Pinterest API v5 OpenAPI description (opens in new tab)

FAQ

Questions

Is this the official Pinterest API?
No. Toolzer Hub is not affiliated with Pinterest. Ours searches public Pinterest pins and videos by keyword, and reads public boards and profiles, with one key.
What does the official Pinterest API allow?
Pinterest's v5 API searches the pins and boards of the account that authorized your app. Its search of pins by term, /v5/search/partner/pins, "is currently in beta and not available to all apps", and new apps start on Trial access with daily rate limits.
What data does it return?
Search pins, Board pins, Profile boards, Profile, Pin details, as JSON.
What does it cost?
1 credit per call. New workspaces get 100 credits a month at no cost; plans work out to $0.99 to $1.45 per 1,000 credits. Failed calls are not charged.

Try the Pinterest API free

Every new workspace gets 100 credits a month. Buy credits only when you need more.

Not affiliated with Pinterest.