Pinterest Topic API. Send a topic or its link.

Ideas page with related topics and search count. We handle the proxies, blocks and platform changes.

Returns a Pinterest ideas page (a topic) from its link or its words. You get its name, Pinterest's summary on category pages, and the related searches it suggests. You also get how many searches Pinterest counts for it, its followers, the broader topics above it, the narrower ones it offers, trending searches and the boards it shows. Words with no ideas page return not_found.

GET /v1/pinterest/topic

Read the API reference

1 credit per request, $0.75–$1.97 per 1,000 requests
8 typed fields null when unknown
url is all it needs, e.g. https://www.pinterest.com/ideas/star-nail-designs/961385779129/
100 credits free when you sign up, no card, so you can build before you spend

Send one request. Get 8 fields 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

url = https://www.pinterest.com/ideas/star-nail-designs/961385779129/

Open in playground

GET /v1/pinterest/topicTry in

const params = new URLSearchParams({
  url: "https://www.pinterest.com/ideas/star-nail-designs/961385779129/",
});
const res = await fetch(`https://socialtap.dev/v1/pinterest/topic?${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, meta } = body;
console.log(data, meta.credits_charged);

import os

import requests

res = requests.get(
    "https://socialtap.dev/v1/pinterest/topic",
    params={"url": "https://www.pinterest.com/ideas/star-nail-designs/961385779129/"},
    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, meta = body["data"], body["meta"]
print(data, meta["credits_charged"])

require "json"
require "net/http"

uri = URI("https://socialtap.dev/v1/pinterest/topic")
uri.query = URI.encode_www_form('url' => 'https://www.pinterest.com/ideas/star-nail-designs/961385779129/')
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([
    'url' => 'https://www.pinterest.com/ideas/star-nail-designs/961385779129/',
]);
$ch = curl_init('https://socialtap.dev/v1/pinterest/topic?' . $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("url", "https://www.pinterest.com/ideas/star-nail-designs/961385779129/")
	req, err := http.NewRequest("GET", "https://socialtap.dev/v1/pinterest/topic?"+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"`
		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 -G 'https://socialtap.dev/v1/pinterest/topic' \
  --data-urlencode 'url=https://www.pinterest.com/ideas/star-nail-designs/961385779129/' \
  -H "x-api-key: $SOCIALTAP_API_KEY"

{
  "data": {
    "approximate_fields": [],
    "description": null,
    "id": "961385779129",
    "name": "Star Nail Designs",
    "platform": "pinterest",
    "platform_specific": {
      "pinterest": {
        "cover_image_url": "https://i.pinimg.com/474x/37/81/19/378119e7f9eb391d50b55b175a04b870.jpg",
        "follower_count": null,
        "is_category": false,
        "is_interest": false,
        "parent_topics": [
          {
            "id": "935541271955",
            "name": "Beauty",
            "url": "https://www.pinterest.com/ideas/beauty/935541271955/"
          },
          {
            "id": "956143059915",
            "name": "Nails",
            "url": "https://www.pinterest.com/ideas/nails/956143059915/"
          },
          {
            "id": "944365099264",
            "name": "Nail Art",
            "url": "https://www.pinterest.com/ideas/nail-art/944365099264/"
          }
        ],
        "refinements": [
          {
            "id": "920700149322",
            "label": "Blue",
            "name": "Blue Star Nail Designs",
            "url": "https://www.pinterest.com/ideas/blue-star-nail-designs/920700149322/"
          },
          {
            "id": "907171573460",
            "label": "Moon",
            "name": "Moon and Star Nail Designs",
            "url": "https://www.pinterest.com/ideas/moon-and-star-nail-designs/907171573460/"
          },
          {
            "id": "945556081760",
            "label": "Black",
            "name": "Black Star Nail Designs",
            "url": "https://www.pinterest.com/ideas/black-star-nail-designs/945556081760/"
          }
        ],
        "related_boards": [
          {
            "id": "1023513521504626611",
            "title": "Nails",
            "url": "https://www.pinterest.com/e18b0cb235799f1d10ec6bbc1873d1/nails/"
          },
          {
            "id": "634866947410870831",
            "title": "Nails",
            "url": "https://www.pinterest.com/ngerceski/nails/"
          },
          {
            "id": "396879854601657012",
            "title": "nails",
            "url": "https://www.pinterest.com/isabellagabriellagordon/nails/"
          }
        ],
        "related_topics": [
          {
            "id": "949217630033",
            "name": "Stars Nails Short",
            "url": "https://www.pinterest.com/ideas/stars-nails-short/949217630033/"
          },
          {
            "id": "960496442969",
            "name": "Starry Nail Designs",
            "url": "https://www.pinterest.com/ideas/starry-nail-designs/960496442969/"
          },
          {
            "id": "945281507083",
            "name": "Stars Nail Art",
            "url": "https://www.pinterest.com/ideas/stars-nail-art/945281507083/"
          }
        ],
        "search_count": 66701,
        "trending_searches": [],
        "updated_at": "2026-11-08T19:12:22Z"
      }
    },
    "related_searches": [
      "Blue Star Nail Designs",
      "Moon and Star Nail Designs",
      "Black Star Nail Designs"
    ],
    "unknown_fields": [],
    "url": "https://www.pinterest.com/ideas/star-nail-designs/961385779129/"
  },
  "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": "topic",
      "id": "961385779129",
      "url": "https://www.pinterest.com/ideas/star-nail-designs/961385779129/"
    },
    "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.topic.get({ url: "https://www.pinterest.com/ideas/star-nail-designs/961385779129/" });
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 = "url=" + encode("https://www.pinterest.com/ideas/star-nail-designs/961385779129/");
        HttpRequest request = HttpRequest.newBuilder()
            .uri(URI.create("https://socialtap.dev/v1/pinterest/topic?" + 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("&",
    "url=" + Uri.EscapeDataString("https://www.pinterest.com/ideas/star-nail-designs/961385779129/"));
var res = await http.GetAsync("https://socialtap.dev/v1/pinterest/topic?" + 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/topic")
        .query(&[("url", "https://www.pinterest.com/ideas/star-nail-designs/961385779129/")])
        .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/topicLong arrays and strings are shortened here. Real responses are complete.Docs

One schema on 2 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 topic: its ideas page link (pinterest.com/ideas/star-nail-designs/961385779129/, also on a country's site such as uk.pinterest.com or pinterest.co.uk) or its words (star nail designs).
Write one parser
Pinterest and Instagram answer in these fields, so the code that reads one reads them all.

platformstring: Platform ID (instagram, tiktok, …).
idstring: Platform-native topic ID; on platforms whose topic pages are keyed by their words (Instagram), the words lowercased and joined by hyphens (harry-potter).
namestring: The topic's title as its page shows it (Harry Potter); null when the source does not show it.
urlstring: Canonical topic page URL.
descriptionstring: The platform's summary of the topic, as plain text with paragraph breaks (on Instagram, superscript markers ¹, ² cite platform_specific.instagram.source_urls by position). Null when the page has none.
related_searchesstring[]: Related searches the platform suggests for the topic, in its order; each is a topic of its own (pass it as url). [] when none.
approximate_fieldsstring[]: JSON paths of values rounded by the platform or parsed from display text ("189M reels": platform_specific.instagram.post_count). [] when all exact.
unknown_fieldsstring[]: JSON paths of lists whose [] means unknown rather than none (a source that cannot see them); null already means unknown for every other field. [] when every list is known.

What teams build with the Pinterest Topic API.

Expand a keyword into related Pinterest searches
Size a niche by its search count
Map a topic's place in Pinterest's categories
Find boards curating a topic

Good to know before you build.

A topic's pins are Pinterest's search results for its words: send the topic's name to the Pinterest Search API.
Case and hyphens are ignored, so Star Nail Designs and star-nail-designs are one topic.
Pinterest knows many search phrases without an ideas page. Those return not_found, as the page itself does.
platform_specific.pinterest.search_count is the number Pinterest's page data states. Pinterest doesn't say over which period it counts.
follower_count is set for interests, the topics accounts can follow (is_interest true), and null for pages made for a search phrase.
description is set on category pages (is_category true). Pinterest writes no summary for most other topics, so it is null there.

1 credit per request. 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 request	Per 1,000 requests
Any source	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 Topic API.

Try it on a link you already have.

Paste it 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 Topic API. Send a topic or its link.

Pinterest Topic API at a glance

Send one request. Get 8 fields back.

One schema on 2 platforms.

Null means unknown

What it accepts

Write one parser

What teams build with the Pinterest Topic API.

Expand a keyword into related Pinterest searches

Size a niche by its search count

Map a topic's place in Pinterest's categories

Find boards curating a topic

Good to know before you build.

1 credit per request. Failed requests are free.

Questions about the Pinterest Topic API.

Topics on 1 more platform.

Pinterest API. 10 endpoints, one key.

Try it on a link you already have.