Pinterest Board Pins
I Pin di una bacheca Pinterest sono le immagini che qualcuno ha raccolto attorno a un’idea, ognuna con un breve titolo o descrizione, l’account che l’ha salvata e la foto originale con larghezza e altezza complete. Presi insieme nell’ordine in cui la bacheca li mostra, formano un set di riferimenti visivi già pronto per mood board, ricerca di design, dataset di immagini e per seguire come cambia una raccolta curata.
Funzionalità della Pinterest Board Pins API
- Pin nell’ordine della bachecaLe righe seguono la sequenza mostrata dalla bacheca, così la raccolta si legge come l’ha disposta chi la cura.
- Immagine originale e miniaturamedia.url punta all’immagine a piena risoluzione e media.thumbnail_url a una piccola anteprima, con larghezza e altezza in pixel per ogni file.
- Chi l’ha salvato e cosa diceauthor indica l’account che ha salvato ogni Pin, con username, nome visualizzato, link al profilo e avatar, mentre text riporta il titolo o la descrizione del Pin.
- Un link a ogni Pinurl è la pagina del Pin, ricostruita dal suo id, così ogni immagine del set riporta al punto in cui si trova su Pinterest.
- Fino a 1.000 Pin da ogni bachecaresults_limit vale per bacheca, è 50 per impostazione predefinita e accetta fino a 1.000, e in urls puoi inviare più bacheche insieme.
Parametri della Pinterest Board Pins API
| Parametri | Obbligatorio | Descrizione |
|---|---|---|
urls | Obbligatorio | Link di bacheche Pinterest nella forma /{username}/{board}/, come https://www.pinterest.com/lizmrodgers/moms-night/. |
results_limit | Facoltativo | Numero massimo di Pin da restituire per ogni bacheca, un intero da 1 a 1.000. Il valore predefinito è 50. |
Come usare la Pinterest Board Pins API
Invia i link delle bacheche, attendi l’attività e leggi i Pin pagina per pagina.
- Invia con POST i link delle bacheche in urls, più results_limit se ti servono più di 50 Pin per bacheca, a /v1/pinterest/board.
- Interroga GET /v1/tasks/{task_id} con il task_id ricevuto finché l’attività non è riuscita.
- Prendi i Pin da results.items e continua a recuperarli con results.next_cursor finché has_more è true.
curl -X POST "https://api.socq.ai/v1/pinterest/board" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://www.pinterest.com/lizmrodgers/moms-night/"],"results_limit":50}'
# 0.5 credits per pin; boards that do not exist return no pins.Casi d’uso della Pinterest Board Pins API
- Scaricare le immagini di una bacheca: Salva ogni media.url di una bacheca per creare una libreria locale di file originali, usando width e height per separare le foto verticali da quelle orizzontali.
- Costruire un dataset di immagini con didascalia: Abbina ogni immagine al text del Pin e alla bacheca di provenienza per raccogliere esempi etichettati per la ricerca di design o l’addestramento di modelli.
- Osservare la bacheca stagionale di un concorrente: Raccogli la stessa bacheca ogni settimana e confronta gli id dei Pin con l’esecuzione precedente per vedere esattamente cosa è stato aggiunto.
- Citare le fonti in una mood board: Conserva author.username e l’url del Pin accanto a ogni immagine, così ogni foto di una presentazione può essere attribuita e riaperta.
Consigli degli esperti per la Pinterest Board Pins API
- Usa il link in due parti della bacheca stessa; le schede del profilo come /{username}/_saved/ o /{username}/pins/, i percorsi più profondi delle sezioni e i link brevi pin.it vengono rifiutati, quindi apri la bacheca e copia il suo indirizzo.
- Controlla prima metrics.pins_count della bacheca con Pinterest User Boards API e imposta results_limit di conseguenza, così una bacheca grande non si ferma ai 50 Pin predefiniti.
- Carica thumbnail_url per griglie e anteprime e scarica media.url solo per le immagini che tieni, risparmiando banda sulle bacheche con centinaia di Pin.
API correlate
Oltre alla Pinterest Board Pins 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 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.