pinterest/
user-pins

Trova i Pin pubblici di Pinterest da uno o più URL di profilo, con identità del Pin, testo, dettagli dell’autore, media, engagement visibile e contesto di origine restituiti come record normalizzati.

Pinterest User Pins API

Input con URL del profilo
Limite di risultati per profilo
Pin pubblici normalizzati
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 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

ParametriObbligatorioDescrizione
urlsObbligatorioElenco 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_limitFacoltativoNumero 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.

  1. Prepara uno o più URL di profili Pinterest pubblici con un solo segmento di percorso del profilo.
  2. Invia con POST urls e un results_limit facoltativo a /v1/pinterest/user-pins, poi salva il task_id restituito.
  3. Interroga /v1/tasks/{task_id} finché l’attività ha successo o restituisce un errore.
  4. 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 true

Casi 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.

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.

Esplora altre piattaforme

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

Pinterest User Pins API — FAQ

Pinterest User Pins API trova i record dei Pin pubblici dagli URL di profili Pinterest inviati. Restituisce identità del Pin, testo, autori, media, engagement visibile, timestamp e contesto di origine normalizzati, anziché record di profilo.

Invia un URL HTTP o HTTPS su un dominio Pinterest supportato il cui percorso contiene esattamente un segmento di profilo non riservato, come /example/. Percorsi di Pin, pagine di ricerca, pagine di idee, percorsi più profondi e link pin.it vengono rifiutati.

I record possono includere ID del Pin, URL, titolo, testo, dettagli pubblici dell’autore, riferimenti a immagini o video, numero visibile di Mi piace, commenti e follower, created_at, collected_at e i campi extra di classificazione e ricerca. I valori facoltativi della fonte possono essere null o vuoti.

results_limit ha come valore predefinito 100 e accetta interi da 1 a 2.000. Si applica a ogni URL di profilo, quindi due URL con results_limit 50 richiedono fino a 100 Pin.

La risposta normalizzata non espone una classificazione stabile tra creati e salvati. Considera i risultati come Pin pubblici trovati dall’URL del profilo inviato, senza dedurre il tipo di appartenenza.

No. Questo endpoint accetta solo URL di profilo e results_limit; non espone un URL di bacheca, un identificatore di bacheca né un parametro di filtro per bacheca.

Ogni record di Pin restituito costa 0,5 crediti SocQ. La stima usa urls moltiplicato per results_limit e un set di risultati vuoto non ha costi per risultato.