pinterest/
user-boards

Elenca le bacheche dei profili Pinterest a partire dai loro URL, con nome, descrizione, copertina, proprietario, data di creazione e numero di Pin, follower, sezioni e collaboratori.

Pinterest User Boards API

Input con URL del profilo
Fino a 500 bacheche per profilo
Numero di Pin e follower
Flag delle bacheche di gruppo
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 User Boards

Una bacheca di Pinterest è una raccolta con un nome di Pin salvati, con descrizione, immagine di copertina e data di creazione, insieme al numero di Pin, follower, sezioni e collaboratori e a un flag che indica se altri account possono aggiungervi contenuti. Lette sull’intero profilo, le bacheche rivelano quali temi l’account cura di più, quali raccolte hanno un seguito proprio e dove apre le porte ai contributi condivisi.

Funzionalità della Pinterest User Boards API

  • Tutte le bacheche di un profiloInvia uno o più link di profili Pinterest in urls e ogni bacheca di quei profili torna come riga a sé, con l’id e l’url della bacheca.
  • Dimensione e pubblico di ogni bachecametrics.pins_count indica quanto è stato salvato in una bacheca e metrics.followers_count quante persone la seguono, così distingui un archivio molto pieno da una raccolta con un pubblico reale.
  • Bacheche di gruppo e sezioniis_collaborative segnala le bacheche a cui altri account possono aggiungere Pin, metrics.collaborators_count dice quanti sono e metrics.sections_count mostra quanto finemente è suddivisa una bacheca.
  • Nome, descrizione, copertina e data di creazionename, text e cover_url dicono a colpo d’occhio di cosa parla una bacheca, mentre published_at registra quando è stata creata e quindi quando quel tema è entrato nell’account.
  • Fino a 500 bacheche per profiloresults_limit si applica a ogni profilo separatamente, vale 25 per impostazione predefinita e accetta fino a 500, così anche gli account con centinaia di bacheche si possono elencare per intero.

Parametri della Pinterest User Boards API

ParametriObbligatorioDescrizione
urlsObbligatorioLink di profili Pinterest con un solo username nel percorso, come https://www.pinterest.com/marthastewart/; funzionano anche i domini nazionali come pinterest.co.uk o de.pinterest.com.
results_limitFacoltativoNumero massimo di bacheche da restituire per ogni profilo, un intero da 1 a 500. Il valore predefinito è 25.

Come usare la Pinterest User Boards API

Invia i link dei profili, attendi l’attività e scorri una riga per ogni bacheca.

  1. Invia i link dei profili e un results_limit facoltativo con POST /v1/pinterest/user-boards e conserva il task_id della risposta.
  2. Chiama GET /v1/tasks/{task_id} ogni pochi secondi finché status non diventa succeeded.
  3. Leggi le bacheche da results.items; finché has_more è true, richiedi la pagina successiva con results.next_cursor.
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}'

# Each board returned costs 0.5 credits.

Casi d’uso della Pinterest User Boards API

  • Analizzare i temi Pinterest di un concorrente: Metti a confronto name e text delle bacheche con pins_count per vedere su quali argomenti un brand continua a salvare, e con followers_count per capire quali raccolte le persone seguono.
  • Selezionare creator per nicchia: Raccogli le bacheche dei creator candidati e abbina nomi e descrizioni al tuo tema, tenendo gli account che lo curano su più bacheche.
  • Trovare bacheche di gruppo a cui unirsi: Tieni le righe con is_collaborative uguale a true e confronta collaborators_count con followers_count per scegliere bacheche condivise con un seguito.
  • Seguire quali raccolte crescono: Raccogli periodicamente gli stessi profili e confronta pins_count e followers_count per id di bacheca per vedere quali guadagnano Pin o follower.

Consigli degli esperti per la Pinterest User Boards API

  • Riduci i link di bacheche e Pin alla radice del profilo prima dell’invio, perché urls accetta https://www.pinterest.com/{username}/; i link delle bacheche vanno invece a Pinterest Board Pins API.
  • Alza results_limit oltre il valore predefinito di 25 quando un profilo ha più bacheche; il limite vale per profilo e vengono addebitate solo le bacheche effettivamente restituite.
  • Raggruppa le righe per author.username quando un’attività copre più profili, perché ogni bacheca riporta i dati dell’account che la possiede.
  • Passa l’url di ogni bacheca a Pinterest Board Pins API per ottenere i suoi Pin, usando metrics.pins_count per decidere quanto alzare il results_limit di quell’endpoint.

Oltre alla Pinterest User Boards 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 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.
  • Pinterest Topic API — Legge gli URL delle pagine delle idee di Pinterest per ottenere le ricerche mensili di ogni argomento, la data di aggiornamento e gli argomenti più specifici suggeriti.

Esplora altre piattaforme

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

Pinterest User Boards API — FAQ

Pinterest User Boards API è un’interfaccia programmatica per elencare le bacheche dei profili pubblici di Pinterest a partire dagli URL dei profili. Per ogni bacheca restituisce nome, descrizione, immagine di copertina, proprietario, data di creazione, flag di collaborazione e numero di Pin, follower, sezioni e collaboratori.

Inserisci il link del profilo in urls e imposta results_limit almeno sul numero di bacheche dell’account, fino a 500. Ogni bacheca torna come riga separata con nome, url e conteggi.

Ogni riga descrive la bacheca stessa, con il numero di Pin che contiene in metrics.pins_count. Per leggere i Pin, invia l’url della bacheca a Pinterest Board Pins API.

Una bacheca collaborativa, spesso chiamata bacheca di gruppo, permette ad account diversi dal proprietario di aggiungere Pin. Per queste bacheche is_collaborative è true e metrics.collaborators_count indica il numero di collaboratori.

Ogni bacheca costa 0,5 crediti, quindi tre profili con il limite predefinito di 25 costano al massimo 37,5 crediti. Un profilo con meno bacheche del limite paga solo quelle restituite.