pinterest/
board

Raccogli i Pin delle bacheche Pinterest dai loro URL nell’ordine della bacheca, con testo del Pin, account che l’ha salvato, immagine a piena risoluzione e miniatura con dimensioni e link al Pin.

Pinterest Board Pins API

Input con URL della bacheca
Pin nell’ordine della bacheca
URL delle immagini originali
Fino a 1.000 Pin per bacheca
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 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

ParametriObbligatorioDescrizione
urlsObbligatorioLink di bacheche Pinterest nella forma /{username}/{board}/, come https://www.pinterest.com/lizmrodgers/moms-night/.
results_limitFacoltativoNumero 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.

  1. 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.
  2. Interroga GET /v1/tasks/{task_id} con il task_id ricevuto finché l’attività non è riuscita.
  3. 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.

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.

Esplora altre piattaforme

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

Pinterest Board Pins API — FAQ

Pinterest Board Pins API è un’interfaccia programmatica per raccogliere i Pin salvati in una bacheca di Pinterest a partire dall’URL della bacheca. Nell’ordine mostrato dalla bacheca restituisce per ogni Pin il testo, l’account che l’ha salvato, l’immagine a piena risoluzione e la miniatura con dimensioni e il link al Pin.

Ogni Pin include media.url, l’indirizzo dell’immagine a piena risoluzione, che puoi scaricare con qualsiasi client HTTP. Imposta results_limit sul numero di Pin della bacheca, fino a 1.000, per coprirla tutta.

author è l’account che ha salvato il Pin nella bacheca, con username, nome visualizzato, url del profilo e avatar.

Ogni Pin costa 0,5 crediti, quindi una bacheca raccolta con i 50 Pin predefiniti costa 25 crediti e una bacheca da 400 Pin ne costa 200.