pinterest/
topic

Consulta gli argomenti di Pinterest dagli URL delle pagine delle idee e ricevi per ognuno il nome, il numero di ricerche mensili indicato da Pinterest, la data di aggiornamento e gli argomenti più specifici suggeriti.

Pinterest Topic API

Input con URL della pagina delle idee
Ricerche mensili
Argomenti correlati con link
0,5 crediti per risultato
Pronto
Pronto

Inserisci i parametri e invia una richiesta. Qui compariranno lo stato dell’attività e i risultati normalizzati.

README

A cura di SocQ · Aggiornato il

Pinterest Topic

Un argomento di Pinterest è una pagina delle idee che raggruppa i Pin attorno a un tema come home decor, con il numero di ricerche mensili che Pinterest gli attribuisce, la data in cui quel dato è stato aggiornato e una serie di argomenti più specifici come le varianti Christmas o Thrifted. Questi dati mostrano quanta domanda ha un tema su Pinterest, mentre gli argomenti più specifici indicano gli stili, le occasioni e i materiali che le persone vi associano, e sono la base per la ricerca di parole chiave e la pianificazione dei contenuti.

Funzionalità della Pinterest Topic API

  • Ricerche mensili per argomentosearch_count è il numero di ricerche mensili che Pinterest indica per l’argomento, una misura diretta di quanto spesso le persone lo cercano.
  • Argomenti più specifici con link proprirelated_topics elenca i sottoargomenti suggeriti da Pinterest, ognuno con nome completo, un’etichetta breve come DIY e l’url della sua pagina delle idee.
  • Data di aggiornamento del datoupdated_at registra quando Pinterest ha aggiornato l’argomento l’ultima volta, così sai quanto è recente il numero di ricerche.
  • Molti argomenti in una richiestaurls accetta più pagine delle idee insieme e ognuna restituisce esattamente una riga, identificata dall’id dell’argomento presente nell’indirizzo della pagina.

Parametri della Pinterest Topic API

ParametriObbligatorioDescrizione
urlsObbligatorioLink di pagine delle idee di Pinterest nella forma /ideas/{topic}/{id}/, compreso l’id numerico, come https://www.pinterest.com/ideas/home-decor/935249274030/.

Come usare la Pinterest Topic API

Invia i link delle pagine delle idee e ricevi una riga per ogni argomento.

  1. Copia da Pinterest i link delle pagine delle idee e inviali con POST in urls a /v1/pinterest/topic.
  2. Interroga GET /v1/tasks/{task_id} finché status non indica succeeded.
  3. Leggi un argomento per elemento in results.items; se has_more è true, recupera il resto con results.next_cursor.
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/"]}'

# One row and 0.5 credits per topic.

Casi d’uso della Pinterest Topic API

  • Ordinare le idee di contenuto per domanda: Raccogli search_count per un elenco di argomenti candidati e lavora su quelli più cercati prima di pianificare Pin o bacheche.
  • Trovare nicchie long tail dentro un tema ampio: Leggi le etichette in related_topics, come Christmas, Thrifted o Earthy Cottage sotto home decor, per scegliere un taglio più stretto con un pubblico chiaro.
  • Costruire il tuo storico della domanda su Pinterest: Raccogli gli stessi argomenti ogni mese e salva search_count con updated_at per mostrare su un grafico come si muove l’interesse per ogni tema.

Consigli degli esperti per la Pinterest Topic API

  • Mantieni l’id numerico in ogni link: /ideas/home-decor/935249274030/ viene accettato, mentre un indirizzo che termina con il nome dell’argomento non supera la validazione.
  • Esplora una nicchia livello per livello inviando related_topics[].url come blocco successivo, ed escludi gli id di argomento già raccolti, perché i rami riportano spesso alle stesse pagine delle idee.
  • Confronta search_count tra argomenti solo insieme a updated_at, perché ogni dato risale all’ultimo aggiornamento di quel singolo argomento.

Oltre alla Pinterest Topic API, usa queste API quando ti serve un altro tipo di dati pubblici di Pinterest.

  • Pinterest Pins API — Trasforma gli URL dei Pin pubblici in contenuti, creator, media, tassonomia, date e metriche visibili normalizzati.
  • Pinterest User Pins API — Individua i Pin pubblici dagli URL dei profili con un limite per profilo e contenuti, creator, media, date e metriche visibili normalizzati.
  • Pinterest Profiles API — Raccoglie identità del profilo pubblico, bio, immagine, sito web, conteggi visibili dell’account e contesto della raccolta dagli URL dei profili.
  • Pinterest Search API — Cerca Pin pubblici per testo con un limite di risultati, restituendo contenuti, creator, media, tassonomia, date e metriche visibili normalizzati.
  • Pinterest User Boards API — Elenca le bacheche dei profili Pinterest dagli URL dei profili, con nomi, descrizioni, copertine, date di creazione e numero di Pin, follower, sezioni e collaboratori.
  • Pinterest Board Pins API — Raccoglie i Pin di una bacheca Pinterest dal suo URL nell’ordine della bacheca, con testo del Pin, account che l’ha salvato, immagini a piena risoluzione e link ai Pin.

Esplora altre piattaforme

Combina i dati di Pinterest con i dati pubblici delle altre piattaforme social supportate.

Pinterest Topic API — FAQ

Pinterest Topic API è un’interfaccia programmatica per leggere gli argomenti di Pinterest a partire dagli URL delle loro pagine delle idee. Per ogni argomento restituisce il nome, il numero di ricerche mensili indicato da Pinterest, la data dell’ultimo aggiornamento di quel numero e gli argomenti più specifici suggeriti sotto di esso.

Fornisce il numero attuale di ricerche mensili che Pinterest indica per ogni argomento, insieme alla data di aggiornamento. Raccogliendo periodicamente gli stessi argomenti costruisci uno storico da rappresentare tu stesso su un grafico.

Le pagine delle idee si trovano sotto pinterest.com/ideas/ e terminano con un id numerico, come in /ideas/home-decor/935249274030/. Ogni riga restituisce anche related_topics[].url, già nella forma accettata.

name è l’argomento completo, per esempio Christmas Home Decor, e label è l’etichetta breve che Pinterest mostra, per esempio Christmas.

Ogni argomento restituito costa 0,5 crediti, quindi consultare dieci pagine delle idee costa 5 crediti.