pinterest/
pins

Raccogli i Pin pubblici di Pinterest da URL diretti dei Pin o da link pin.it, con contenuti, dettagli del creator, media, timestamp e metriche visibili restituiti come record normalizzati.

Pinterest Pins API

Input con URL del Pin
Contesto di creator e media
Istantanea delle metriche visibili
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 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

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

  1. Prepara uno o più URL pubblici Pinterest /pin/{id} o link brevi pin.it.
  2. Invia i link come urls a /v1/pinterest/pins 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/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 true

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

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.

Esplora altre piattaforme

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

Pinterest Pins API — FAQ

Pinterest Pins API recupera i record dei Pin pubblici da URL diretti di Pin Pinterest o da link brevi supportati. Restituisce contenuti normalizzati, dettagli del creator, media, timestamp, categorie, hashtag e metriche visibili.

Invia un URL HTTP o HTTPS su un dominio Pinterest il cui percorso inizia con /pin/{id}, oppure usa un link breve pin.it. Profili, ricerche, idee e altri percorsi vengono rifiutati.

No. L’endpoint risolve solo i link pubblici ai Pin supportati in urls e non trasforma il profilo di un creator in un feed.

L’array media normalizzato può contenere riferimenti pubblici a immagini o video. Resta vuoto quando il record di origine non espone un URL di media utilizzabile.

Un Pin pubblico può non esporre media, data di pubblicazione, categorie, hashtag, tipo di post o ogni metrica visibile, quindi i valori facoltativi possono essere null o vuoti.

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