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
| Parametri | Obbligatorio | Descrizione |
|---|---|---|
urls | Obbligatorio | Elenco 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.
- Prepara uno o più URL di profili Pinterest pubblici il cui percorso contiene un solo segmento di nome utente.
- Invia i link come urls a /v1/pinterest/profiles 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/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 trueCasi 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.
API correlate
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.