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
usernamestringrequiredPinterest 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"import requests
res = requests.get(
"https://api.pindataapi.com/v1/users/profile?username=",
headers={"x-api-key": "pn_live_your_api_key"},
timeout=30,
)
print(res.json())const res = await fetch("https://api.pindataapi.com/v1/users/profile?username=", {
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": {
"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.
| Field | Type | Sample / Notes |
|---|---|---|
code | integer | Example: 0 |
provider | string | |
status | string | Example: ok |
data | object | |
profile | NormalizedProfile | |
username | string | |
user_id | stringnull | |
full_name | string | |
bio | stringnull | |
website_url | stringnull | |
avatar_url | stringnull | |
verified_merchant | boolean | |
follower_count | integer | |
pin_count | integernull | |
board_count | integernull | |
dominant_palette | array of string | |
sample_pins | array of object | |
profile_url | string | |
meta | ResponseMeta | |
request_id | string | |
endpoint | string | |
credits_charged | integer | |
cached | boolean | |
took_ms | integer |
Status Codes
- 200
- Normalized Pinterest creator / merchant profile.
- 401
- 404