Pinterest Topic API
curl --request POST \
--url https://api.socq.ai/v1/pinterest/topic \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"urls": [
"<string>"
],
"callback_url": "<string>"
}
'import requests
url = "https://api.socq.ai/v1/pinterest/topic"
payload = {
"urls": ["<string>"],
"callback_url": "<string>"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({urls: ['<string>'], callback_url: '<string>'})
};
fetch('https://api.socq.ai/v1/pinterest/topic', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.socq.ai/v1/pinterest/topic",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'urls' => [
'<string>'
],
'callback_url' => '<string>'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.socq.ai/v1/pinterest/topic"
payload := strings.NewReader("{\n \"urls\": [\n \"<string>\"\n ],\n \"callback_url\": \"<string>\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.socq.ai/v1/pinterest/topic")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"urls\": [\n \"<string>\"\n ],\n \"callback_url\": \"<string>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.socq.ai/v1/pinterest/topic")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"urls\": [\n \"<string>\"\n ],\n \"callback_url\": \"<string>\"\n}"
response = http.request(request)
puts response.read_body{
"code": 200,
"data": {
"task_id": "<string>",
"status": "<string>",
"created_time": "<string>"
}
}{
"code": 422,
"error": {
"message": "<string>",
"type": "<string>",
"details": {}
}
}Pinterest
Pinterest Topic
Get the monthly search count and related topics of a Pinterest idea page.
POST
/
v1
/
pinterest
/
topic
Pinterest Topic API
curl --request POST \
--url https://api.socq.ai/v1/pinterest/topic \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"urls": [
"<string>"
],
"callback_url": "<string>"
}
'import requests
url = "https://api.socq.ai/v1/pinterest/topic"
payload = {
"urls": ["<string>"],
"callback_url": "<string>"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({urls: ['<string>'], callback_url: '<string>'})
};
fetch('https://api.socq.ai/v1/pinterest/topic', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.socq.ai/v1/pinterest/topic",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'urls' => [
'<string>'
],
'callback_url' => '<string>'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.socq.ai/v1/pinterest/topic"
payload := strings.NewReader("{\n \"urls\": [\n \"<string>\"\n ],\n \"callback_url\": \"<string>\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.socq.ai/v1/pinterest/topic")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"urls\": [\n \"<string>\"\n ],\n \"callback_url\": \"<string>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.socq.ai/v1/pinterest/topic")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"urls\": [\n \"<string>\"\n ],\n \"callback_url\": \"<string>\"\n}"
response = http.request(request)
puts response.read_body{
"code": 200,
"data": {
"task_id": "<string>",
"status": "<string>",
"created_time": "<string>"
}
}{
"code": 422,
"error": {
"message": "<string>",
"type": "<string>",
"details": {}
}
}Pinterest Topic
Size up a Pinterest topic before you build content for it. For each idea page you get the monthly search count Pinterest reports and the narrower topics it suggests underneath, such as the styles, occasions and materials people combine with the main idea. It works as keyword research for Pinterest: compare demand across topics, find long-tail angles, and plan boards around what people actually search for.{
"urls": [
"https://www.pinterest.com/ideas/home-decor/935249274030/"
]
}
Standard Result Fields
Task results use the stable SocQ fields below. Source-specific field names and formats are normalized without inferring or enriching values that the source did not provide. To request a smaller field set, usefields for MCP queries, _result_fields for typed tools, or --result-fields in the CLI. Declared fields remain present when their value is null.
| Field | Type | Nullable | Description |
|---|---|---|---|
id | string | Yes | Unique identifier for this result item. |
platform | string | No | Platform the result belongs to, such as instagram or linkedin. |
resource | string | No | SocQ resource represented by the result, such as videos or comments. |
type | string | No | Category of the result item, such as video, post, or comment. |
url | string | Yes | URL of the topic’s idea page. |
published_at | string | Yes | Time the source item was published, in ISO 8601 format when available. |
collected_at | string | No | Time SocQ collected or processed this result, in ISO 8601 format. |
name | string | Yes | Name of the Pinterest topic. |
search_count | integer | Yes | Monthly search count Pinterest reports for the topic. |
updated_at | string | Yes | Time Pinterest last refreshed the topic, in ISO 8601 format. |
related_topics | array<object> | Yes | Narrower topics Pinterest suggests under this one. |
related_topics.name | string | Yes | Full name of the narrower topic. |
related_topics.label | string | Yes | Short label shown for the narrower topic, such as DIY. |
related_topics.url | string | Yes | URL of the narrower topic’s idea page. |
Completed Task Response
{
"code": 200,
"data": {
"task_id": "example-pinterest-topic",
"status": "succeeded",
"public_id": "pinterest/topic",
"result_count": 1,
"credits_amount": 0.5,
"results": {
"limit": 50,
"next_cursor": null,
"has_more": false,
"schema_id": "topic",
"schema_version": "1.0",
"items": [
{
"id": "935249274030",
"platform": "pinterest",
"resource": "topic",
"type": "topic",
"url": "https://www.pinterest.com/ideas/home-decor/935249274030/",
"published_at": null,
"collected_at": "2026-11-17T14:41:09.727864Z",
"name": "home decor",
"search_count": 3548161,
"updated_at": "2026-11-04T20:23:19Z",
"related_topics": [
{
"name": "Home Decor Ideas",
"label": "Ideas",
"url": "https://www.pinterest.com/ideas/home-decor-ideas/897707546790/"
},
{
"name": "Diy Home Decor",
"label": "Diy",
"url": "https://www.pinterest.com/ideas/diy-home-decor/944798509834/"
},
{
"name": "Earthy Cottage Home Decor",
"label": "Earthy Cottage",
"url": "https://www.pinterest.com/ideas/earthy-cottage-home-decor/943886138925/"
},
{
"name": "Christmas Home Decor",
"label": "Christmas",
"url": "https://www.pinterest.com/ideas/christmas-home-decor/935502310471/"
},
{
"name": "Thrifted Home Decor",
"label": "Thrifted",
"url": "https://www.pinterest.com/ideas/thrifted-home-decor/898181173829/"
}
]
}
]
}
}
}
Authorizations
bearerAuthapiKeyAuth
Body
application/json
Provide Pinterest idea page URLs in urls, using /ideas/{topic}/{id}/. Each topic returns one row with its monthly search count and the narrower topics Pinterest suggests under it.

