Torna alle API
Dati pubblici di Pinterest

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.

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àSocQAPI di Pinterest
Uso principaleRaccogliere profili pubblici, Pin, Pin degli utenti e risultati di ricercaGestire contenuti, annunci, analytics e cataloghi autorizzati
OAuth del clienteChiave API di SocQ; nessun OAuth Pinterest del clienteApp Pinterest, token di accesso e scope richiesti
Input inizialeURL pubblico di un profilo o di un Pin, oppure una query di testoContesto di un account autorizzato e ID delle risorse di Pinterest
Creare o gestire PinNon supportatoSupportato per conto di un utente autenticato con scope di scrittura
Formato della rispostaRecord normalizzati di SocQOggetti 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. 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. 2. Segui l’attività

    Interroga /v1/tasks/{task_id} finché l’elaborazione non è completata.

  3. 3. Recupera i risultati

    Leggi data.results.items e usa next_cursor finché has_more è true.

Cerca Pin pubblici per parola chiave

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 true

Casi 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.

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.