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
| Parametri | Obbligatorio | Descrizione |
|---|---|---|
urls | Obbligatorio | Link 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_limit | Facoltativo | Numero 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.
- Invia i link dei profili e un results_limit facoltativo con POST /v1/pinterest/user-boards e conserva il task_id della risposta.
- Chiama GET /v1/tasks/{task_id} ogni pochi secondi finché status non diventa succeeded.
- 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.
API correlate
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.