Pinterest Profile Pins API. Pins, page by page.

Every pin an account saved or created, page by page. We handle the proxies, blocks and platform changes.

Returns a public Pinterest account's pins from its username, profile link or ID, newest first, page by page. Each pin has its title, description, hashtags, picture or video files, exact saves, reactions and comments, the page it links to, its board and the account that first pinned it. List every pin the account saved, or only the ones it created.

GET /v1/pinterest/pins

Read the API reference

1 credit per page, $0.75–$1.97 per 1,000 pages
22 typed fields null when unknown
25 pins per page, newest first
handle is all it needs, e.g. pinterest

Send one request. Get up to 25 pins back.

Copy the request in your language, or hand it to your agent. Sign up for an API key and your first 100 credits are free.

$ npm install socialtap

handle = pinterest

Open in playground

GET /v1/pinterest/pinsTry in

const params = new URLSearchParams({
  handle: "pinterest",
});
const res = await fetch(`https://socialtap.dev/v1/pinterest/pins?${params}`, {
  headers: { "x-api-key": process.env.SOCIALTAP_API_KEY ?? "" },
});
const body = await res.json();
if (!res.ok) throw new Error(`${body.error.code}: ${body.error.message}`);
const { data, page, meta } = body;
console.log(data, meta.credits_charged);

import os

import requests

res = requests.get(
    "https://socialtap.dev/v1/pinterest/pins",
    params={"handle": "pinterest"},
    headers={"x-api-key": os.environ["SOCIALTAP_API_KEY"]},
)
body = res.json()
if not res.ok:
    raise RuntimeError(f"{body['error']['code']}: {body['error']['message']}")
data, page, meta = body["data"], body["page"], body["meta"]
print(data, meta["credits_charged"])

require "json"
require "net/http"

uri = URI("https://socialtap.dev/v1/pinterest/pins")
uri.query = URI.encode_www_form('handle' => 'pinterest')
req = Net::HTTP::Get.new(uri)
req["x-api-key"] = ENV.fetch("SOCIALTAP_API_KEY")
res = Net::HTTP.start(uri.host, uri.port, use_ssl: uri.scheme == "https") { |http| http.request(req) }
body = JSON.parse(res.body)
raise "#{body["error"]["code"]}: #{body["error"]["message"]}" unless res.is_a?(Net::HTTPSuccess)
pp body["data"]
puts body["meta"]["credits_charged"]

<?php

$query = http_build_query([
    'handle' => 'pinterest',
]);
$ch = curl_init('https://socialtap.dev/v1/pinterest/pins?' . $query);
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['x-api-key: ' . getenv('SOCIALTAP_API_KEY')],
]);
$body = json_decode(curl_exec($ch), true);
if (curl_getinfo($ch, CURLINFO_RESPONSE_CODE) >= 400) {
    throw new RuntimeException($body['error']['code'] . ': ' . $body['error']['message']);
}
print_r($body['data']);
echo $body['meta']['credits_charged'], PHP_EOL;

package main

import (
	"encoding/json"
	"fmt"
	"log"
	"net/http"
	"net/url"
	"os"
)

func main() {
	q := url.Values{}
	q.Set("handle", "pinterest")
	req, err := http.NewRequest("GET", "https://socialtap.dev/v1/pinterest/pins?"+q.Encode(), nil)
	if err != nil {
		log.Fatal(err)
	}
	req.Header.Set("x-api-key", os.Getenv("SOCIALTAP_API_KEY"))
	res, err := http.DefaultClient.Do(req)
	if err != nil {
		log.Fatal(err)
	}
	defer res.Body.Close()
	var body struct {
		Data  json.RawMessage `json:"data"`
		Page  json.RawMessage `json:"page"`
		Meta  map[string]any  `json:"meta"`
		Error *struct {
			Code    string `json:"code"`
			Message string `json:"message"`
		} `json:"error"`
	}
	if err := json.NewDecoder(res.Body).Decode(&body); err != nil {
		log.Fatal(err)
	}
	if body.Error != nil {
		log.Fatalf("%s: %s", body.Error.Code, body.Error.Message)
	}
	fmt.Println(string(body.Data), body.Meta["credits_charged"])
}

curl 'https://socialtap.dev/v1/pinterest/pins?handle=pinterest' \
  -H "x-api-key: $SOCIALTAP_API_KEY"

{
  "data": [
    {
      "approximate_fields": [],
      "author": {
        "avatar_url": "https://i.pinimg.com/280x280_RS/1c/b5/61/1cb561c8e7b9c709f78d110a4b5f0863.jpg",
        "display_name": "Pinterest",
        "id": "424605208526455283",
        "is_verified": true,
        "url": "https://www.pinterest.com/pinterest/",
        "username": "pinterest"
      },
      "coauthors": [],
      "duration_ms": null,
      "hashtags": [],
      "id": "424605071146306109",
      "is_nsfw": null,
      "is_pinned": null,
      "is_sponsored": false,
      "language": null,
      "media": [
        {
          "alt_text": null,
          "duration_ms": null,
          "expires_at": null,
          "height": 1599,
          "thumbnail_url": "https://i.pinimg.com/originals/e3/b2/88/e3b288ad73798578086a4bcafde8eafd.jpg",
          "type": "image",
          "url": "https://i.pinimg.com/originals/e3/b2/88/e3b288ad73798578086a4bcafde8eafd.jpg",
          "width": 1199
        }
      ],
      "mentions": [],
      "metrics": {
        "comment_count": 0,
        "like_count": 9,
        "quote_count": null,
        "repost_count": null,
        "save_count": 323,
        "share_count": null,
        "view_count": null
      },
      "platform": "pinterest",
      "platform_specific": {
        "pinterest": {
          "author_follower_count": 6269070,
          "board": {
            "id": "424605139808130646",
            "title": "Easy and chic holiday nail ideas",
            "url": "https://www.pinterest.com/pinterest/easy-and-chic-holiday-nail-ideas/"
          },
          "caption_languages": [],
          "domain": null,
          "dominant_color": "#563a27",
          "interests": [],
          "is_ad": false,
          "is_author_verified_merchant": false,
          "is_repin": true,
          "link_url": null,
          "original_pinner": {
            "avatar_url": "https://i.pinimg.com/280x280_RS/4a/7e/c4/4a7ec41a64ea9df0a2a34d0e22834c9c.jpg",
            "display_name": "Lauren",
            "id": "631770791385517160",
            "is_verified": false,
            "url": "https://www.pinterest.com/lrnglenn/",
            "username": "lrnglenn"
          },
          "repin_count": null,
          "rich_type": null
        }
      },
      "platform_type": "idea_pin",
      "published_at": "2026-11-09T19:14:02Z",
      "text": null,
      "thumbnail_url": "https://i.pinimg.com/originals/e3/b2/88/e3b288ad73798578086a4bcafde8eafd.jpg",
      "title": "🪩✨",
      "type": "image",
      "unknown_fields": [
        "platform_specific.pinterest.interests"
      ],
      "url": "https://www.pinterest.com/pin/424605071146306109/"
    },
    {
      "approximate_fields": [],
      "author": {
        "avatar_url": "https://i.pinimg.com/280x280_RS/1c/b5/61/1cb561c8e7b9c709f78d110a4b5f0863.jpg",
        "display_name": "Pinterest",
        "id": "424605208526455283",
        "is_verified": true,
        "url": "https://www.pinterest.com/pinterest/",
        "username": "pinterest"
      },
      "coauthors": [],
      "duration_ms": null,
      "hashtags": [
        "beyoncé",
        "nailtech"
      ],
      "id": "424605071146306108",
      "is_nsfw": null,
      "is_pinned": null,
      "is_sponsored": false,
      "language": null,
      "media": [
        {
          "alt_text": null,
          "duration_ms": null,
          "expires_at": null,
          "height": 1666,
          "thumbnail_url": "https://i.pinimg.com/originals/e3/9e/69/e39e69304ea39fffbfa904935faff40b.jpg",
          "type": "image",
          "url": "https://i.pinimg.com/originals/e3/9e/69/e39e69304ea39fffbfa904935faff40b.jpg",
          "width": 1440
        }
      ],
      "mentions": [],
      "metrics": {
        "comment_count": 0,
        "like_count": 8,
        "quote_count": null,
        "repost_count": null,
        "save_count": 187,
        "share_count": null,
        "view_count": null
      },
      "platform": "pinterest",
      "platform_specific": {
        "pinterest": {
          "author_follower_count": 6269070,
          "board": {
            "id": "424605139808130646",
            "title": "Easy and chic holiday nail ideas",
            "url": "https://www.pinterest.com/pinterest/easy-and-chic-holiday-nail-ideas/"
          },
          "caption_languages": [],
          "domain": "instagram.com",
          "dominant_color": "#93897f",
          "interests": [],
          "is_ad": false,
          "is_author_verified_merchant": false,
          "is_repin": true,
          "link_url": "https://www.instagram.com/p/DJvUrGMgyJQ/",
          "original_pinner": {
            "avatar_url": "https://i.pinimg.com/280x280_RS/7d/d4/67/7dd467eb766ae86468f9423e86ff1743.jpg",
            "display_name": "Nicxbeauttyy",
            "id": "1009510210131239142",
            "is_verified": false,
            "url": "https://www.pinterest.com/nicxbeautty/",
            "username": "nicxbeautty"
          },
          "repin_count": null,
          "rich_type": null
        }
      },
      "platform_type": "pin",
      "published_at": "2026-11-09T19:13:44Z",
      "text": "A moment for the disco nails #beyoncé #nailtech",
      "thumbnail_url": "https://i.pinimg.com/originals/e3/9e/69/e39e69304ea39fffbfa904935faff40b.jpg",
      "title": null,
      "type": "image",
      "unknown_fields": [
        "platform_specific.pinterest.interests"
      ],
      "url": "https://www.pinterest.com/pin/424605071146306108/"
    },
    {
      "approximate_fields": [],
      "author": {
        "avatar_url": "https://i.pinimg.com/280x280_RS/1c/b5/61/1cb561c8e7b9c709f78d110a4b5f0863.jpg",
        "display_name": "Pinterest",
        "id": "424605208526455283",
        "is_verified": true,
        "url": "https://www.pinterest.com/pinterest/",
        "username": "pinterest"
      },
      "coauthors": [],
      "duration_ms": null,
      "hashtags": [],
      "id": "424605071146306107",
      "is_nsfw": null,
      "is_pinned": null,
      "is_sponsored": false,
      "language": null,
      "media": [
        {
          "alt_text": null,
          "duration_ms": null,
          "expires_at": null,
          "height": 1211,
          "thumbnail_url": "https://i.pinimg.com/originals/80/d8/c9/80d8c92c74168ea8c66d5681d0b719d4.jpg",
          "type": "image",
          "url": "https://i.pinimg.com/originals/80/d8/c9/80d8c92c74168ea8c66d5681d0b719d4.jpg",
          "width": 1014
        }
      ],
      "mentions": [],
      "metrics": {
        "comment_count": 0,
        "like_count": 5,
        "quote_count": null,
        "repost_count": null,
        "save_count": 189,
        "share_count": null,
        "view_count": null
      },
      "platform": "pinterest",
      "platform_specific": {
        "pinterest": {
          "author_follower_count": 6269070,
          "board": {
            "id": "424605139808130646",
            "title": "Easy and chic holiday nail ideas",
            "url": "https://www.pinterest.com/pinterest/easy-and-chic-holiday-nail-ideas/"
          },
          "caption_languages": [],
          "domain": null,
          "dominant_color": "#aa8878",
          "interests": [],
          "is_ad": false,
          "is_author_verified_merchant": false,
          "is_repin": true,
          "link_url": null,
          "original_pinner": {
            "avatar_url": "https://i.pinimg.com/280x280_RS/81/1c/32/811c32b5bf66eecd20d7185caf897909.jpg",
            "display_name": "Kimberly Reyn",
            "id": "431712451688407077",
            "is_verified": false,
            "url": "https://www.pinterest.com/amazon_chic/",
            "username": "amazon_chic"
          },
          "repin_count": null,
          "rich_type": null
        }
      },
      "platform_type": "idea_pin",
      "published_at": "2026-11-09T19:13:38Z",
      "text": "Nail idea for the holidays",
      "thumbnail_url": "https://i.pinimg.com/originals/80/d8/c9/80d8c92c74168ea8c66d5681d0b719d4.jpg",
      "title": "Christmas | Holiday Set",
      "type": "image",
      "unknown_fields": [
        "platform_specific.pinterest.interests"
      ],
      "url": "https://www.pinterest.com/pin/424605071146306107/"
    }
  ],
  "page": {
    "has_more": true,
    "next_cursor": "c1.EXAMPLE_CURSOR",
    "next_cursor_expires_at": "2026-10-26T12:00:00Z",
    "end_reason": null
  },
  "meta": {
    "request_id": "req_3f9c2a7d1e8b4c6a9f0e2d4b6a8c0e1f",
    "platform": "pinterest",
    "source": "api",
    "is_cached": false,
    "credits_charged": 1,
    "latency_ms": 0,
    "fetched_at": "2026-10-25T12:00:00Z",
    "input": {
      "kind": "profile",
      "id": "424605208526455283",
      "url": "https://www.pinterest.com/pinterest/"
    },
    "credits_remaining": 9999,
    "client_request_id": null,
    "warnings": []
  }
}

import { SocialTap } from "socialtap";

const client = new SocialTap(); // apiKey defaults to process.env.SOCIALTAP_API_KEY

const res = await client.pinterest.pins.list({ handle: "pinterest" });
console.log(res.data);
console.log(res.credits.charged, res.meta.request_id);

import java.net.URI;
import java.net.URLEncoder;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.nio.charset.StandardCharsets;

public class Main {
    public static void main(String[] args) throws Exception {
        String query = "handle=" + encode("pinterest");
        HttpRequest request = HttpRequest.newBuilder()
            .uri(URI.create("https://socialtap.dev/v1/pinterest/pins?" + query))
            .header("x-api-key", System.getenv("SOCIALTAP_API_KEY"))
            .GET()
            .build();
        HttpResponse<String> response = HttpClient.newHttpClient()
            .send(request, HttpResponse.BodyHandlers.ofString());
        // An error is {"error": {"code", "message", ...}}; success is {data, meta}, meta.credits_charged its price.
        if (response.statusCode() >= 400) throw new RuntimeException(response.body());
        System.out.println(response.body());
    }

    static String encode(String value) {
        return URLEncoder.encode(value, StandardCharsets.UTF_8);
    }
}

using System.Text.Json;

using var http = new HttpClient();
http.DefaultRequestHeaders.Add("x-api-key", Environment.GetEnvironmentVariable("SOCIALTAP_API_KEY"));

var query = string.Join("&",
    "handle=" + Uri.EscapeDataString("pinterest"));
var res = await http.GetAsync("https://socialtap.dev/v1/pinterest/pins?" + query);
using var body = JsonDocument.Parse(await res.Content.ReadAsStringAsync());
if (!res.IsSuccessStatusCode)
{
    var error = body.RootElement.GetProperty("error");
    throw new Exception($"{error.GetProperty("code")}: {error.GetProperty("message")}");
}
Console.WriteLine(body.RootElement.GetProperty("data"));
Console.WriteLine(body.RootElement.GetProperty("meta").GetProperty("credits_charged"));

// Cargo.toml: reqwest = { version = "0.12", features = ["blocking", "json"] }, serde_json = "1"
use std::env;

fn main() -> Result<(), Box<dyn std::error::Error>> {
    let res = reqwest::blocking::Client::new()
        .get("https://socialtap.dev/v1/pinterest/pins")
        .query(&[("handle", "pinterest")])
        .header("x-api-key", env::var("SOCIALTAP_API_KEY")?)
        .send()?;
    let ok = res.status().is_success();
    let body: serde_json::Value = res.json()?;
    if !ok {
        return Err(format!("{}: {}", body["error"]["code"], body["error"]["message"]).into());
    }
    println!("{} {}", body["data"], body["meta"]["credits_charged"]);
    Ok(())
}

200 OK · GET https://socialtap.dev/v1/pinterest/pinsLong arrays and strings are shortened here. Real responses are complete.Docs

One schema on 21 platforms.

The response reference lists every field, its type and when it is null. See the full schema.

Null means unknown
A field Pinterest doesn't show is null, never zero or an empty string, so a real zero always means zero.
What it accepts
The Pinterest account: its username (any case, with or without the @), its profile link (pinterest.com/<username>/, any of its tabs such as /_created/ or /_pins/, also on a country's site such as uk.pinterest.com or pinterest.co.uk) or its numeric ID.
Write one parser
Pinterest, TikTok, Instagram and 18 more platforms answer in these fields, so the code that reads one reads them all.

platformstring: Platform ID (tiktok, youtube, …).
idstring: Platform-native post ID (string; Instagram shortcode, Reddit with its t3_ prefix).
urlstring: Canonical post URL.
typestring: Normalized content shape. New values may be added; treat unknown values as other.
platform_typestring: The platform's own product label, lowercase (reel, short, story, live, tweet, …).
titlestring: Headline (YouTube title, Reddit title); null on caption-only platforms.
textstring: Caption, description or body as plain text.
languagestring: BCP-47 language of text, when the platform states it.

What teams build with the Pinterest Profile Pins API.

Track what a brand pins each week
Collect a creator's pins and their saves
Find the sites an account sends traffic to
Download an account's pin pictures and videos

Good to know before you build.

tab=saved lists the account's Pins tab, which holds the pins it saved from others too: each of those has platform_specific.pinterest.is_repin true and names who pinned it first in original_pinner.
Pinterest orders the Pins tab by when each pin was saved, but can list a pin out of that order. So since and until filter its pages without ending the walk; on tab=created, which is in strict order, paging stops once since is reached.
Pinterest leaves an idea pin's description out of these lists, so its text is null here. The Pinterest Pin API returns it, with the pin's interests, which are listed in unknown_fields here.
metrics.save_count counts the saves of every pin of the same picture or video. metrics.share_count is null, as is platform_specific.pinterest.repin_count on tab=saved: those lists don't carry them.
When Pinterest's main API fails on a first page, the pins come from its embed API: no title, date, reactions or comments, a carousel shows only its cover, and the list stops there with page.end_reason platform_limit.

1 credit per page. Failed requests are free.

Buy credits once and spend them on any endpoint, on any platform.

Plans and packs How this endpoint is priced How credits work

Source	Price per successful page	Per 1,000 pages
Platform API `api`	1 credit	$0.75–$1.97

Cache hits are free.
Credits from packs and top-ups never expire.
A monthly plan's credits are spent first, and what is left of them ends at each renewal.
Prices exclude tax: sales tax is added at checkout where it applies.
Outside the US, plans and packs are sold to businesses: checkout asks for your VAT, GST or other business tax ID.

Questions about the Pinterest Profile Pins API.

Try it on an account you know.

Paste its handle or link in the playground, or copy the request into your code.

free credits

No credit card
Failed requests are free
Works on all 218 endpoints

Start for free Read the docs

Pinterest Profile Pins API. Pins, page by page.

Pinterest Profile Pins API at a glance

Send one request. Get up to 25 pins back.

One schema on 21 platforms.

Null means unknown

What it accepts

Write one parser

What teams build with the Pinterest Profile Pins API.

Track what a brand pins each week

Collect a creator's pins and their saves

Find the sites an account sends traffic to

Download an account's pin pictures and videos

Good to know before you build.

1 credit per page. Failed requests are free.

Questions about the Pinterest Profile Pins API.

Posts on 20 more platforms.

Pinterest API. 10 endpoints, one key.

Try it on an account you know.