Pinterest User Pins
I Pinterest User Pins sono post visivi pubblici associati a un profilo e rappresentati da titoli, descrizioni, dettagli del creator, riferimenti ai media, categorie, hashtag, timestamp ed engagement visibile. Questi campi di contenuto e di osservazione supportano l’archiviazione delle raccolte dei profili, la ricerca su argomenti visivi, l’attribuzione delle fonti e il confronto al momento della raccolta.
Funzionalità della Pinterest User Pins API
- Ricerca di Pin basata sul profiloAccetta uno o più URL di profili Pinterest pubblici e restituisce i record dei Pin associati a ciascun profilo inviato, anziché i metadati del profilo.
- Profondità di raccolta per profiloApplica results_limit separatamente a ogni URL di profilo, con un valore predefinito di 100 e un intervallo accettato da 1 a 2.000.
- Record normalizzati di Pin, autore e mediaRestituisce identificatori dei Pin, URL, titoli, testi, campi pubblici dell’autore e riferimenti a immagini o video in una struttura di risultato coerente.
- Engagement e contesto di origineConserva il numero visibile di Mi piace, commenti e follower del creator insieme a data di pubblicazione, collected_at, campi di classificazione e discovery_input, quando disponibili.
Parametri della Pinterest User Pins API
| Parametri | Obbligatorio | Descrizione |
|---|---|---|
urls | Obbligatorio | Elenco obbligatorio di URL di profili Pinterest pubblici, HTTP o HTTPS, con esattamente un segmento di percorso non riservato; gli URL di Pin, ricerche, idee e pin.it vengono rifiutati. |
results_limit | Facoltativo | Numero massimo di Pin richiesti per ogni URL di profilo; il valore predefinito è 100 e accetta interi da 1 a 2.000. |
Come usare la Pinterest User Pins API
Invia gli URL dei profili Pinterest pubblici con un limite di risultati per profilo, segui l’attività asincrona e leggi i Pin normalizzati con la paginazione a cursore.
- Prepara uno o più URL di profili Pinterest pubblici con un solo segmento di percorso del profilo.
- Invia con POST urls e un results_limit facoltativo a /v1/pinterest/user-pins, poi salva il task_id restituito.
- Interroga /v1/tasks/{task_id} finché l’attività ha successo o restituisce un errore.
- Leggi data.results.items e richiedi il next_cursor restituito finché has_more resta true.
curl -X POST "https://api.socq.ai/v1/pinterest/user-pins" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://www.pinterest.com/example/"],"results_limit":100}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is trueCasi d’uso della Pinterest User Pins API
- Archiviazione dei Pin di profili pubblici: Conserva ID dei Pin, URL di origine, titoli, testi, campi dell’autore, riferimenti ai media, timestamp e discovery_input per URL di profilo definiti.
- Ricerca visiva e sulla tassonomia: Usa tipo di media, post_type, categorie, hashtag, titoli e testi per esaminare formati e temi ricorrenti nei profili pubblici selezionati.
- Confronto dei segnali tra profili: Confronta il numero visibile di Mi piace e commenti con il contesto dei follower del creator tra più raccolte di profili, usando collected_at come riferimento per ogni rilevazione.
Consigli degli esperti per la Pinterest User Pins API
- Invia un URL di profilo Pinterest pubblico con esattamente un segmento di percorso del profilo; link ai Pin, link brevi pin.it, pagine di ricerca e percorsi più profondi non superano la validazione del profilo.
- Calcola la profondità richiesta e la stima dei crediti prima della richiesta come numero di urls moltiplicato per results_limit, perché il limite si applica separatamente a ogni profilo.
- Salva discovery_input e collected_at con ogni Pin, così i dataset a valle conservano il profilo inviato e il momento dell’osservazione.
- Considera media, created_at, categorie, hashtag, source, dettagli dell’autore e le singole metriche come facoltativi, e non dedurre se un Pin sia stato creato o salvato quando non viene restituita alcuna classificazione.
API correlate
Oltre alla Pinterest User 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 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.