pinterest/
profiles

Raccogli i profili Pinterest pubblici da uno o più URL di profilo, con identità, bio e sito web, immagini del profilo e numeri visibili dell’account restituiti come record normalizzati.

Pinterest Profiles API

Input con URL del profilo
Campi di identità e sito web
Metriche visibili dell’account
0,6 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 Profiles

I profili Pinterest sono pagine pubbliche di account con nomi utente, nomi visualizzati, bio, immagini del profilo, siti web collegati e numero visibile di follower, seguiti, bacheche e salvati. Questi campi di identità e segnali dell’account supportano l’arricchimento dei profili, il confronto tra account pubblici e il monitoraggio nel tempo.

Funzionalità della Pinterest Profiles API

  • Ambito degli URL di profili pubbliciElabora uno o più URL di profili Pinterest supportati, escludendo link ai Pin, link brevi, pagine di ricerca e altri percorsi che non sono profili.
  • Identità e presentazione del profiloRestituisce in un unico record normalizzato ID del profilo, URL canonico, nome utente, nome visualizzato, bio, immagine del profilo e sito web collegato.
  • Numeri visibili dell’accountMantiene come metriche separate il numero disponibile di follower, seguiti, bacheche e salvati, per il confronto a livello di account.
  • Contesto di raccolta e di origineAggiunge collected_at insieme a codice paese, URL della pagina dei Pin creati, valore di aggiornamento della fonte e input di ricerca, quando disponibili, senza mescolarli ai campi di identità.

Parametri della Pinterest Profiles API

ParametriObbligatorioDescrizione
urlsObbligatorioElenco obbligatorio di URL di profili Pinterest pubblici. Ogni URL deve usare HTTP o HTTPS su un dominio Pinterest e contenere un solo segmento di percorso con un nome utente non riservato.

Come usare la Pinterest Profiles API

Invia gli URL dei profili pubblici che già conosci, segui l’attività asincrona e leggi i record dei profili normalizzati con la paginazione a cursore.

  1. Prepara uno o più URL di profili Pinterest pubblici il cui percorso contiene un solo segmento di nome utente.
  2. Invia i link come urls a /v1/pinterest/profiles e conserva il task_id.
  3. Interroga /v1/tasks/{task_id} finché l’elaborazione ha successo o restituisce un errore.
  4. 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/profiles" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://www.pinterest.com/example/"]}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is true

Casi d’uso della Pinterest Profiles API

  • Arricchimento di profili pubblici: Aggiungi nome utente, nome visualizzato, bio, immagine del profilo, sito web e contesto del paese ai record collegati a URL di profili già noti.
  • Confronto della presenza degli account: Confronta il numero visibile di follower, seguiti, bacheche e salvati su un insieme selezionato di profili pubblici.
  • Monitoraggio dei profili pubblici: Salva campi di identità e metriche visibili con collected_at per confrontare la presentazione dei profili e i segnali degli account in momenti di raccolta diversi.

Consigli degli esperti per la Pinterest Profiles API

  • Usa un URL completo di profilo Pinterest, HTTP o HTTPS, con un solo segmento di nome utente; pin.it, /pin/, /search/ e altri percorsi riservati vengono rifiutati.
  • Normalizza gli URL inviati e deduplica i profili restituiti per id quando è disponibile, usando url come chiave stabile alternativa.
  • Considera bio, immagine, sito web, codice paese, valore di aggiornamento della fonte, URL della pagina dei Pin creati e le singole metriche come campi facoltativi.
  • Tieni collected_at accanto ai numeri visibili dell’account, così le esecuzioni successive restano distinguibili come istantanee pubbliche separate.
  • Usa Pinterest User Pins API quando ti servono i record dei Pin di un profilo; questo endpoint restituisce metadati e numeri del profilo, non bacheche, Pin o elenchi del pubblico.

Oltre alla Pinterest Profiles 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 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 Profiles API — FAQ

Pinterest Profiles API recupera i metadati dei profili pubblici da uno o più URL di profili Pinterest supportati. Restituisce identità normalizzata, bio, immagine del profilo, sito web, numeri visibili dell’account e contesto di raccolta.

Invia un URL completo, HTTP o HTTPS, su un dominio Pinterest il cui percorso contiene un solo segmento di nome utente non riservato. URL dei Pin, link pin.it, pagine di ricerca e percorsi riservati come /ideas/ o /today/ vengono rifiutati.

I risultati possono includere ID del profilo, URL, nome utente, nome visualizzato, bio, avatar, sito web, numero di follower e di seguiti, numero di bacheche e di salvati, orario di raccolta, codice paese e URL della pagina dei Pin creati.

No. Restituisce metadati del profilo e conteggi aggregati visibili, non record di bacheche, record di Pin né i membri degli elenchi di follower e seguiti; usa Pinterest User Pins API quando ti servono i Pin trovati da un URL di profilo.

Un profilo pubblico può non esporre bio, sito web, immagine, codice paese, URL della pagina dei Pin creati, valore di aggiornamento della fonte o ogni conteggio visibile. I client devono accettare valori facoltativi null o vuoti.

Ogni record di profilo in un risultato completato costa 0,6 crediti SocQ. Un set di risultati vuoto non ha costi per risultato.