Pinterest Public Data API
Recupera dati pubblici dei profili Pinterest, risolvi Pin noti, raccogli i Pin di profili selezionati o cerca per parola chiave per ricerche su creator, contenuti e tendenze visive.
API di Pinterest disponibili
Usa Profiles per i dati degli account, Pins per un Pin noto, User Pins per i contenuti di profili selezionati o Search per scoprire i Pin con le parole chiave.

pinterest/profiles
Profili0,6 crediti per risultato

pinterest/pins
Post0,5 crediti per risultato

pinterest/user-pins
Post0,5 crediti per risultato

pinterest/search
Ricerca0,6 crediti per risultato

pinterest/user-boards
Profili0,5 crediti per risultato

pinterest/board
Post0,5 crediti per risultato

pinterest/topic
Ricerca0,5 crediti per risultato
Quali dati di Pinterest puoi recuperare?
SocQ restituisce record pubblici normalizzati di account e Pin con identità, contenuti, media, classificazione, scoperta, engagement e contesto del momento della raccolta.
Dettagli pubblici del profilo
Recupera ID del profilo, nomi utente, nomi visualizzati, bio, immagini, siti web collegati, contesto del paese e conteggi visibili dell’account.
Contenuti e media dei Pin
Recupera identità del Pin, titolo, testo, dettagli del creator, riferimenti ai media, data di pubblicazione e metriche visibili, quando disponibili.
Raccolte di Pin dei creator
Sfoglia un insieme limitato di Pin pubblici degli URL di profilo selezionati e mantieni ogni risultato collegato al profilo inviato.
Argomenti e classificazione
Cerca i Pin per parola chiave e conserva tipo di post, categorie, hashtag, dettagli sulla fonte e input di scoperta, quando disponibili.
SocQ vs API di Pinterest
SocQ si concentra sulla raccolta di dati pubblici supportati di Pinterest. L’API ufficiale di Pinterest è pensata per integrazioni autenticate di contenuti, pubblicità, analytics e cataloghi.
| Funzionalità | SocQ | API di Pinterest |
|---|---|---|
| Uso principale | Raccogliere profili pubblici, Pin, Pin degli utenti e risultati di ricerca | Gestire contenuti, annunci, analytics e cataloghi autorizzati |
| OAuth del cliente | Chiave API di SocQ; nessun OAuth Pinterest del cliente | App Pinterest, token di accesso e scope richiesti |
| Input iniziale | URL pubblico di un profilo o di un Pin, oppure una query di testo | Contesto di un account autorizzato e ID delle risorse di Pinterest |
| Creare o gestire Pin | Non supportato | Supportato per conto di un utente autenticato con scope di scrittura |
| Formato della risposta | Record normalizzati di SocQ | Oggetti nativi dell’API di Pinterest |
Come funziona l’API di Pinterest
Tutte e quattro le API di Pinterest usano lo stesso flusso di lavoro con attività asincrona e risultati paginati.
1. Invia il tuo input
Invia URL di profili, URL di Pin o una query di ricerca all’API corrispondente e salva il task_id restituito.
2. Segui l’attività
Interroga /v1/tasks/{task_id} finché l’elaborazione non è completata.
3. Recupera i risultati
Leggi data.results.items e usa next_cursor finché has_more è true.
Autenticati con la tua chiave API di SocQ e invia una query di testo. Profiles, Pins e User Pins usano lo stesso flusso di attività.
curl -X POST "https://api.socq.ai/v1/pinterest/search" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query":"home office ideas","results_limit":100}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is trueCasi d’uso comuni dell’API di Pinterest
Ricerca su creator e profili
Arricchisci gli URL di profilo noti con identità pubblica, bio, sito web, contesto del paese, conteggi visibili e momento della raccolta.
Analisi di Pin noti
Trasforma gli URL dei Pin selezionati in contenuto, creator, media, tassonomia, date, metriche visibili e link alla fonte.
Monitoraggio dei contenuti dei creator
Raccogli insiemi limitati di Pin da profili selezionati e confronta contenuti e istantanee degli account al momento della raccolta.
Ricerca su argomenti e tendenze visive
Cerca parole chiave definite per creare dataset strutturati di Pin con creator, media, classificazione e contesto di scoperta.
Limiti e policy sui dati pubblici
I risultati di Pinterest sono record pubblici riferiti a un preciso momento. Queste API non accedono a contenuti privati e non creano, modificano, salvano né gestiscono profili e Pin.
- Profiles richiede un URL di profilo con un solo segmento di percorso per il nome utente. Restituisce i dettagli dell’account, non bacheche, Pin o elenchi del pubblico.
- Pins richiede un URL pubblico noto /pin/{id} o un link pin.it e non trasforma un profilo in una raccolta di Pin.
- User Pins richiede URL di profili pubblici. results_limit ha il valore predefinito 100, accetta da 1 a 2.000 e si applica separatamente a ogni profilo.
- Search richiede una sola query di testo. results_limit ha il valore predefinito 100 e accetta da 1 a 2.000; ordinamento e filtri aggiuntivi non sono disponibili.
- I campi facoltativi di identità, contenuto, media, classificazione, fonte, data e metriche possono essere null o vuoti se la fonte pubblica non li espone.
- Le API sono di sola lettura e non creano, modificano, salvano né gestiscono profili, bacheche o Pin di Pinterest.
Domande frequenti sull’API di Pinterest
Che cos’è l’API di Pinterest?
L’API di Pinterest è un insieme di endpoint di SocQ per recuperare dati pubblici dei profili, risolvere Pin noti, raccogliere i Pin di profili selezionati e cercare Pin pubblici per parola chiave.
Quale API di Pinterest devo usare?
Usa Profiles per i dettagli degli account, Pins per i link /pin/{id} o pin.it noti, User Pins per una raccolta limitata a partire da URL di profili e Search per scoprire contenuti con le parole chiave.
Profiles e User Pins restituiscono gli stessi dati?
No. Profiles restituisce i metadati dell’account e i conteggi aggregati, mentre User Pins restituisce record di Pin normalizzati trovati a partire dagli URL di profilo inviati.
Come funziona il limite dei risultati di User Pins?
results_limit ha il valore predefinito 100, accetta numeri interi da 1 a 2.000 e si applica separatamente a ogni URL di profilo.
Perché i campi possono essere null o vuoti?
Un profilo o un Pin pubblico può non esporre, al momento della raccolta, tutti i valori di identità, contenuto, media, tassonomia, fonte, data o metriche.
Quanto costa la raccolta di dati da Pinterest?
Ogni profilo o Pin di Search restituito costa 0,6 crediti, mentre ogni Pin restituito da Pins o User Pins costa 0,5 crediti. Gli insiemi di risultati vuoti non hanno alcun costo per i risultati.
Combina i dati di più piattaforme per analisi di business più complete
Riunisci in un unico flusso i dati pubblici di profili, contenuti ed engagement di piattaforme diverse per monitorare brand, creator e argomenti e condurre monitoraggi e analisi cross-platform in modo più efficiente.
Threads API
Recupera profili Threads pubblici, risolvi post noti o raccogli i post di profili selezionati con campi normalizzati su identità, contenuti, media, engagement e date.
Bluesky API
Recupera i profili pubblici di Bluesky, risolvi URL di post noti o raccogli una pagina di post di un account, con campi normalizzati di identità, contenuti, media, timestamp ed engagement visibile.
Snapchat API
Recupera uno Spotlight pubblico noto di Snapchat come record normalizzato con i campi disponibili su creator, didascalia, media, audio, data, durata ed engagement.
Twitch API
Risolvi un nome utente Twitch pubblico noto in un profilo normalizzato, raccogli il suo inventario di video pubblici o recupera una clip con il suo video scaricabile per ricerca sui creator, arricchimento del catalogo, confronto e monitoraggio con istantanee.
Rednote API
Recupera profili e note pubblici, cerca note o utenti, raccogli commenti e risposte annidate e acquisisci una pagina di consigli della home.
Kwai API
Recupera profili Kwai pubblici, una pagina di post di un account o un post noto, con identità, contenuti, media, timestamp ed engagement visibile normalizzati.