Skip to content
All endpoints

Inspect Pinterest creator or verified merchant profile

GET/v1/users/profile· Updated 2026-11-15

Returns follower count, verified merchant status, website URL, signature 5-swatch color palette, and sample pins for any public Pinterest creator or brand handle. Cost: 10 Credits (0 Credits if not found).

Parameters

  • usernamestringrequired

    Pinterest handle (without @) or full profile URL.

Example Request (cURL / Python / JavaScript)

curl "https://api.pindataapi.com/v1/users/profile?username=" \
  -H "x-api-key: pn_live_your_api_key"

Live Response Preview

{
  "code": 0,
  "provider": "https://pindataapi.com",
  "status": "ok",
  "msg": "success",
  "data": {
    "profile": {
      "username": "archdigest",
      "user_id": "VXNlcjoyNTYyODMxNzI0NTM0ODM1ODI=",
      "full_name": "Architectural Digest",
      "bio": null,
      "website_url": null,
      "avatar_url": null,
      "verified_merchant": false,
      "follower_count": 3729260,
      "following_count": null,
      "pin_count": 25,
      "board_count": null,
      "monthly_views": null,
      "dominant_palette": [
        "#867F73",
        "#8F8D27",
        "#54493C",
        "#756036",
        "#8E7242"
      ],
      "sample_pins": [
        {
          "pin_id": "256283035040940616",
          "title": "Nickey Kehoe’s New Collection With The Lacquer Company Takes Its Cues From Beloved Antiques",
          "image_url": "https://i.pinimg.com/736x/f4/fc/08/f4fc0819ea766aeb00841b05ce4650e3.jpg",
          "width": 736,
          "height": 1104,
          "dominant_color": "#867F73",
          "saves_count": 1
        },
        {
          "pin_id": "256283035040940256",
          "title": "Bunny Williams Never Set Out to Collect Birdhouses—Now a Village of Them Stands in Her Garden",
          "image_url": "https://i.pinimg.com/736x/1f/9e/de/1f9ede22857acf96733ab7ec6d58399a.jpg",
          "width": 736,
          "height": 1104,
          "dominant_color": "#8F8D27",
          "saves_count": 0
        },
        {
          "pin_id": "256283035040940067",
          "title": "How One Designer Brought a Discerning Eye to Her Deeply Personal Manhattan Apartment",
          "image_url": "https://i.pinimg.com/736x/a2/ca/1b/a2ca1bbf02a89ba4165fe0ee65d87ac8.jpg",
          "width": 736,
          "height": 1104,
          "dominant_color": "#54493C",
          "saves_count": 0
        },
        {
          "pin_id": "256283035040938062",
          "title": "How One Creative Couple Found Harmony in Their 1920s Los Angeles Craftsman",
          "image_url": "https://i.pinimg.com/736x/f7/9b/a9/f79ba990f134d5581068d93b2cf1d136.jpg",
          "width": 736,
          "height": 1104,
          "dominant_color": "#756036",
          "saves_count": 0
        },
        {
          "pin_id": "256283035040937808",
          "title": "Artists Helen Marden and the Late Brice Marden Refashioned a Decommissioned Ferry Terminal",
          "image_url": "https://i.pinimg.com/736x/44/84/c9/4484c9803f8c4855dbd3f90905bca93c.jpg",
          "width": 736,
          "height": 1104,
          "dominant_color": "#8E7242",
          "saves_count": 0
        },
        {
          "pin_id": "256283035040935240",
          "title": "Joseph Dirand Joins with Peter Brant and Stephanie Seymour Brant to Reimagine a Historic Mansion",
          "image_url": "https://i.pinimg.com/736x/a6/02/b5/a602b53b79a93749d2bf978d806ae358.jpg",
          "width": 736,
          "height": 1104,
          "dominant_color": "#BEA87B",
          "saves_count": 0
        },
        {
          "pin_id": "256283035040933508",
          "title": "How a Society Photographer Fell in Love With an Unexpected Upstate Victorian Home",
          "image_url": "https://i.pinimg.com/736x/f3/9d/82/f39d82b3386280077e979f879601989d.jpg",
          "width": 736,
          "height": 1104,
          "dominant_color": "#292C39",
          "saves_count": 1
        },
        {
          "pin_id": "256283035040933098",
          "title": "The 17 Most Beautiful Ski Resorts to Visit This Winter—Including Three in the US",
          "image_url": "https://i.pinimg.com/736x/2e/09/ff/2e09ff8ec187bcfc4fbe8d96683e0d4f.jpg",
          "width": 736,
          "height": 1104,
          "dominant_color": "#0F7A87",
          "saves_count": 0
        }
      ],
      "profile_url": "https://www.pinterest.com/archdigest/"
    }
  },
  "meta": {
    "request_id": "33e9445b-b7d5-440d-9b40-a1d9d9921b50",
    "endpoint": "/v1/users/profile",
    "credits_charged": 10,
    "cached": false,
    "took_ms": 2374
  }
}

Response Fields

Normalized Pinterest creator / merchant profile.

FieldTypeSample / Notes
codeintegerExample: 0
providerstring
statusstringExample: ok
dataobject
profileNormalizedProfile
usernamestring
user_idstringnull
full_namestring
biostringnull
website_urlstringnull
avatar_urlstringnull
verified_merchantboolean
follower_countinteger
pin_countintegernull
board_countintegernull
dominant_palettearray of string
sample_pinsarray of object
profile_urlstring
metaResponseMeta
request_idstring
endpointstring
credits_chargedinteger
cachedboolean
took_msinteger

Status Codes

200
Normalized Pinterest creator / merchant profile.
401
404