Pinterest Pins
I Pin di Pinterest sono post visivi pubblici con titoli, descrizioni, dettagli del creator, riferimenti a immagini o video, categorie, hashtag ed engagement visibile. Questi record supportano l’archiviazione di contenuti selezionati, la ricerca creativa e tematica, l’attribuzione e il confronto al momento della raccolta.
Funzionalità della Pinterest Pins API
- URL diretti e brevi dei PinElabora uno o più URL pubblici Pinterest /pin/{id} o link brevi pin.it, limitando la raccolta ai Pin inviati.
- Campi collegati di contenuto e creatorRestituisce titolo e testo del Pin insieme all’URL di origine, all’identità pubblica del creator, all’URL del profilo e ai riferimenti normalizzati a immagini o video.
- Metriche visibili con orario di rilevazioneConserva il numero disponibile di Mi piace e commenti e il numero di follower del creator insieme a collected_at, così i valori pubblici modificabili hanno un’istantanea chiara nel tempo.
- Contesto di classificazione del PinMantiene post_type, categorie e hashtag disponibili in extra per l’analisi di formati e argomenti, senza appiattirli nel testo del Pin.
Parametri della Pinterest Pins API
| Parametri | Obbligatorio | Descrizione |
|---|---|---|
urls | Obbligatorio | Elenco obbligatorio di URL pubblici Pinterest /pin/{id} o di link brevi pin.it. Gli altri percorsi di Pinterest e gli host che non sono Pinterest vengono rifiutati. |
Come usare la Pinterest Pins API
Invia i Pin pubblici esatti che ti servono, segui l’attività asincrona e leggi i record dei Pin normalizzati con la paginazione a cursore.
- Prepara uno o più URL pubblici Pinterest /pin/{id} o link brevi pin.it.
- Invia i link come urls a /v1/pinterest/pins e conserva il task_id.
- Interroga /v1/tasks/{task_id} finché l’elaborazione ha successo o restituisce un errore.
- Leggi data.results.items, poi richiedi la pagina successiva con next_cursor finché has_more è true.
curl -X POST "https://api.socq.ai/v1/pinterest/pins" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://www.pinterest.com/pin/123456789/"]}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is trueCasi d’uso della Pinterest Pins API
- Archiviazione di Pin selezionati: Conserva ID dei Pin, URL di origine, titoli, testi, campi del creator, riferimenti ai media e data di pubblicazione per un elenco definito di URL.
- Analisi creativa e tematica: Usa tipo di media, post_type, categorie, hashtag, titoli e testi per confrontare formati e temi tra Pin selezionati.
- Confronto dei segnali al momento della raccolta: Confronta il numero visibile di Mi piace e commenti con il contesto dei follower del creator, usando collected_at come riferimento per ogni rilevazione.
Consigli degli esperti per la Pinterest Pins API
- Usa per ogni elemento un URL pubblico /pin/{id} o un link pin.it; profili, ricerche, idee e altri percorsi di Pinterest non rispettano la regola di input di questo endpoint.
- Deduplica i valori id restituiti quando un link diretto e uno abbreviato possono portare allo stesso Pin.
- Considera media, created_at, categorie, hashtag, post_type e le singole metriche come campi facoltativi, perché un Pin pubblico può non esporre ogni valore.
- Salva collected_at accanto alle metriche visibili, così le esecuzioni successive si leggono come istantanee distinte al momento della raccolta.
API correlate
Oltre alla Pinterest Pins API, usa queste API quando ti serve un altro tipo di dati pubblici di Pinterest.
- 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.
- 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.