I primi endpoint Pinterest di SocQ leggono profili, singoli pin, i pin di un utente e i risultati di ricerca. Il 2026-11-17 ne sono arrivati altri tre, che lavorano a un livello diverso: bacheche e argomenti. Le bacheche mostrano come un brand o un creator organizza le idee; gli argomenti mostrano quante persone cercano un’idea e quali idee più specifiche le stanno sotto.
Questa guida spiega cosa restituisce ciascun nuovo endpoint, come si fa la richiesta, quanto costa e come i tre si combinano. Se stai confrontando in generale i fornitori di dati Pinterest, vedi Le 7 migliori API scraper per Pinterest.
Risposta rapida: invia URL di profili, bacheche o pagine idea di Pinterest in
urlsaPOST /v1/pinterest/user-boards,/boardo/topicconAuthorization: Bearer $SOCQ_API_KEY. InterrogaGET /v1/tasks/{task_id}finchéstatusnon èsucceeded, poi leggidata.results.items. Tutti e tre costano 0.5 crediti per risultato ($0.0025 a $0.005 per credito), senza costo base.
I tre nuovi endpoint Pinterest
| Endpoint | Cosa restituisce | Input | Prezzo |
|---|---|---|---|
| User Boards | Le bacheche pubbliche di un profilo con nome, descrizione, copertina, proprietario, data di creazione e conteggi di pin, follower, sezioni e collaboratori | URL di profili | 0.5 crediti ($0.0025) per bacheca |
| Board Pins | I pin di una bacheca, nell’ordine della bacheca, con descrizione, utente che l’ha salvato, immagine a grandezza piena e link al pin | URL di bacheche | 0.5 crediti ($0.0025) per pin |
| Topic | Il numero di ricerche mensili di un argomento e i sotto-argomenti suggeriti da Pinterest | URL di pagine idea | 0.5 crediti ($0.0025) per argomento |
Pinterest User Boards: analizzare un profilo
La Pinterest User Boards API elenca tutte le bacheche pubbliche di un profilo Pinterest. Ogni bacheca include nome, descrizione, immagine di copertina, proprietario, data di creazione e conteggi di pin, follower, sezioni e collaboratori, più un flag is_collaborative per le bacheche a cui altri account possono aggiungere pin. È la prima chiamata quando analizzi il Pinterest di un concorrente o selezioni creator per tema: i conteggi mostrano su quali temi un account investe e quali raccolte le persone seguono davvero.
curl -X POST "https://api.socq.ai/v1/pinterest/user-boards" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"urls": ["https://www.pinterest.com/marthastewart/"],
"results_limit": 25
}'
Usa URL di profili come https://www.pinterest.com/username/. results_limit vale per ciascun profilo, ha come valore predefinito 25 e accetta da 1 a 500. I conteggi della bacheca stanno sotto metrics: pins_count, followers_count, sections_count e collaborators_count. Vedi la documentazione di User Boards.
Pinterest Board Pins: raccogliere il contenuto di una bacheca
La Pinterest Board Pins API restituisce i pin di una bacheca, nell’ordine in cui la bacheca li mostra. Ogni pin include titolo o descrizione, l’account che l’ha salvato, l’immagine a grandezza piena (con miniatura e dimensioni sotto media) e l’URL del pin. Puntala su una bacheca curata della tua nicchia per raccogliere immagini di riferimento, seguire cosa un concorrente continua ad aggiungere a una bacheca stagionale o costruire in un solo passaggio un dataset per un mood board.
curl -X POST "https://api.socq.ai/v1/pinterest/board" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"urls": ["https://www.pinterest.com/lizmrodgers/moms-night/"],
"results_limit": 50
}'
Usa URL di bacheche nella forma /{username}/{board}/. results_limit vale per ciascuna bacheca, ha come valore predefinito 50 e accetta da 1 a 1,000. Vedi la documentazione di Board Pins.
Pinterest Topic: ricerca di parole chiave per Pinterest
La Pinterest Topic API misura un argomento prima che tu crei contenuti su di esso. Per ogni pagina idea ottieni il numero di ricerche mensili riportato da Pinterest (search_count) e i sotto-argomenti che suggerisce (related_topics, ciascuno con nome, etichetta breve e URL della propria pagina idea), come gli stili, le occasioni e i materiali che le persone abbinano all’idea principale.
curl -X POST "https://api.socq.ai/v1/pinterest/topic" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"urls": ["https://www.pinterest.com/ideas/home-decor/935249274030/"]
}'
Usa URL di pagine idea nella forma /ideas/{topic}/{id}/. Ogni argomento restituisce una riga. Poiché ogni sotto-argomento ha il proprio URL, puoi ripassare quegli URL allo stesso endpoint per confrontare la domanda tra angolazioni long tail. Vedi la documentazione di Topic.
Come si combinano i tre endpoint
Uno studio tipico su un concorrente o su una nicchia li concatena:
- User Boards sul profilo di un concorrente, per vedere quali bacheche hanno più follower e pin.
- Board Pins sulle bacheche che contano, per raccogliere le immagini e le descrizioni che contengono.
- Topic sulle pagine idea di quei temi, per verificare la domanda di ricerca mensile e trovare angolazioni più specifiche.
Per singoli pin, i pin di un utente o i risultati di ricerca per parola chiave, usa gli endpoint già esistenti Pins, User Pins e Search. Tutti gli endpoint Pinterest sono elencati nella pagina della piattaforma Pinterest.
Autenticazione e flusso asincrono dei task
Ogni richiesta porta la tua chiave API e un content type JSON:
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
Ogni chiamata di invio avvia un task in background:
submit -> task_id -> queued -> running -> succeeded
\-> failed
La risposta all’invio restituisce data.task_id e data.status. Interroga il task con la stessa chiave:
curl "https://api.socq.ai/v1/tasks/$TASK_ID?limit=50" \
-H "Authorization: Bearer $SOCQ_API_KEY"
Finché il task è queued, running o failed, la risposta contiene solo i metadati del task; in caso di failed, leggi error_message. Quando è succeeded, la stessa risposta include la prima pagina di record normalizzati in data.results.items. limit ha come valore predefinito 50 e arriva fino a 500. Se has_more è true, passa results.next_cursor come cursor per leggere la pagina successiva. fields accetta fino a 50 campi o percorsi con punto separati da virgole quando ti servono solo alcune colonne, per esempio name,metrics.followers_count per le bacheche.
Un timeout lato client non annulla il task, quindi riprendi con lo stesso task_id invece di inviare di nuovo e pagare un duplicato. Per evitare il polling, aggiungi callback_url al body dell’invio; SocQ invia una POST con un riepilogo del task quando termina, e tu leggi i record dall’endpoint del task.
Quanto costa un lavoro tipico
- Elencare 25 bacheche di un profilo: 25 × 0.5 = 12.5 crediti, $0.0625.
- Raccogliere 1,000 pin da una bacheca: 500 crediti, $2.50.
- Verificare 20 argomenti: 10 crediti, $0.05.
Poiché results_limit vale per profilo o per bacheca, una richiesta con più URL può restituire fino a quel numero di righe per ciascuno. Imposta il limite tenendo conto del numero di URL.
FAQ
User Boards restituisce bacheche private o segrete?
No. Elenca le bacheche pubbliche di un profilo.
Cosa significa il conteggio di ricerche di Topic?
search_count è il numero di ricerche mensili che Pinterest riporta per la pagina idea. updated_at è il momento in cui Pinterest ha aggiornato l’argomento l’ultima volta.
Posso ottenere i pin di più bacheche in una sola richiesta?
Sì. Inserisci più URL di bacheche in urls. results_limit vale separatamente per ciascuna bacheca, e ogni pin restituito costa 0.5 crediti.
Pago se una bacheca è vuota?
Non c’è un costo base, quindi paghi solo le bacheche, i pin o gli argomenti restituiti.
Dove sono indicati i prezzi di Pinterest?
Ogni landing page mostra la propria tariffa, e la pagina dei prezzi elenca la tariffa attuale in crediti di ogni API SocQ.
PINTEREST API
Prova il flusso di lavoro con un URL pubblico di Pinterest
Invia input pubblici e ricevi record normalizzati con un contesto di origine tracciabile.
Scopri le API di Pinterest