API Pinterest Dettagli del Pin
Stato di salute dell'API
- Operatività nelle ultime 24 ore
- Normale
- Buono / normale
- Disponibile
- Limitato
- Quasi del tutto inattivo
Ultime 24 ore
Ultimi 30 giorni
Recupera un Pin di Pinterest da un link /pin/ con il suo ID numerico. Ottieni contenuti multimediali, link in uscita e dominio, testo alternativo, colore dominante, bacheca e metriche di interazione. Qui i link alle bacheche vengono rifiutati. Il sito di destinazione non viene né scansionato né concesso in licenza.
Invia POST https://api.everyinfra.com/api/v1/social con platform impostato su pinterest e action impostato su pin. Prezzo $1.39 per 1.000 richieste ($0.001389 per chiamata). Le chiamate non riuscite e i risultati vuoti non vengono addebitati. Sincrona. Per i job più lenti, aggiungi "mode": "async" al corpo della richiesta, recupera il job_id ed esegui il polling.
Pinterest Pin details legge un Pin a partire dal suo link e restituisce titolo e descrizione, l'immagine o il video, il link in uscita in external_link con il relativo source_domain, il numero di repin, reazioni, commenti e condivisioni, alt_text e dominant_color dell'immagine, la bacheca in cui è stato salvato, l'autore e la data di pubblicazione. Mostra com'è costruito un singolo Pin e quanta strada ha fatto, per marketer che analizzano i propri Pin o quelli di un concorrente, merchant che vogliono sapere verso quali siti i Pin indirizzano le persone e analisti che completano i dettagli di link a Pin raccolti altrove.
Passa un link che contiene /pin/ seguito dall'ID numerico del Pin, ad esempio https://www.pinterest.com/pin/140806234732511/; un link a una bacheca qui non funziona. Leggi prima repin_count, perché è tramite i salvataggi che i Pin si diffondono su Pinterest. dominant_color è un valore esadecimale che puoi passare direttamente all'analisi visiva, e un comment_count o share_count null significa che il conteggio non è stato reso pubblico, non che è zero.
Prompt per l'AI
#Aiutami a scrivere uno script di raccolta dei dati con l'endpoint Pinterest Dettagli del Pin di EveryInfra (pinterest/pin).
Come funziona l'endpoint:
- Richiesta: POST https://api.everyinfra.com/api/v1/social con l'header Authorization: Bearer <chiave API>. Leggi la chiave dalla variabile d'ambiente EVERYINFRA_API_KEY e non scriverla mai direttamente nel codice.
- Nel corpo della richiesta imposta platform su pinterest e action su pin, e inserisci i parametri in params.
- Parametri obbligatori:
- url: Specifica l'URL di destinazione per le richieste a Pinterest. L'azione pin richiede l'URL di un pin contenente /pin/NUMERIC_ID/, mentre board_detail richiede il link di una bacheca nel formato /username/boardname/ (o il…
- Restituisce un oggetto. Campi principali: id, url, title, text, image_url, video_url, media_type, external_link, source_domain, reaction_count, repin_count, comment_count; 20 campi in totale, elenco completo su https://api.everyinfra.com/api/v1/social/catalog?platform=pinterest.
- Esempio di corpo della richiesta:
{
"platform": "pinterest",
"action": "pin",
"params": {
"url": "https://www.pinterest.com/pin/140806234732511/"
}
}
- Prezzo: $1.39 per 1.000 richieste; le richieste non riuscite e i risultati vuoti non vengono addebitati.
- Per decine o centinaia di target, aggiungi "mode": "async" al corpo: ricevi subito un job_id ed esegui il polling su GET https://api.everyinfra.com/api/v1/jobs/{job_id} per ottenere il risultato.
- In caso di 422, correggi la richiesta usando i nomi dei parametri e i valori consentiti suggeriti nell'errore; in caso di 429 o 503, attendi il tempo indicato da Retry-After e riprova.
Prima di scrivere il codice, chiedimi quali target mi servono, quanti, quali campi e quale formato di output voglio; poi conferma con me il piano e il costo indicativo.Parametri della richiesta
#| Nome | Posizione | Tipo | Obbligatorio | Predefinito | Descrizione |
|---|---|---|---|---|---|
Authorization | header | string | Sì | - | Bearer seguito dalla tua chiave API. Creala nella console; non inserirla mai in un URL o in un repository di codice. |
platform | body | string | Sì | pinterest | Identificativo della piattaforma, valore fisso. |
action | body | string | Sì | pin | Identificativo della funzionalità, valore fisso. |
url | body.params | string | Sì | - | Specifica l'URL di destinazione per le richieste a Pinterest. L'azione pin richiede l'URL di un pin contenente /pin/NUMERIC_ID/, mentre board_detail richiede il link di una bacheca nel formato /username/boardname/ (o il suo percorso relativo). Gli URL delle bacheche non possono sostituire gli URL dei pin. |
Esempi di codice
#curl -X POST 'https://api.everyinfra.com/api/v1/social' \
-H "Authorization: Bearer $EVERYINFRA_API_KEY" \
-H 'Content-Type: application/json' \
--data-raw '{
"platform": "pinterest",
"action": "pin",
"params": {
"url": "https://www.pinterest.com/pin/140806234732511/"
}
}'Definizione OpenAPI (JSON)Gli esempi leggono la chiave dalla variabile d'ambiente EVERYINFRA_API_KEY; il codice copiato non contiene mai la tua chiave.
Esempio di risposta
#{ "id": "req_…", "platform": "pinterest", "action": "pin", "results": { "id": "140806234732511", "url": "https://www.pinterest.com/pin/140806234732511/", "title": "", "text": " ", "image_url": "https://i.pinimg.com/originals/ea/82/df/ea82df375393b9980685116e440c1dc5.jpg", "media_type": "image", "source_domain": "Uploaded by user", "reaction_count": 484, "repin_count": 3170, "comment_count": 0, "share_count": 374, "dominant_color": "#5f4832", "posted_at": "2025-12-31T15:05:40+00:00", "author_username": "•••", "author_name": "•••", "board_name": "Bougie Morning", "platform": "pinterest" }, "billing": { "charged": …, "charged_usd": …, "balance_after_usd": …, … }, "quota": { … }}
Campi della risposta
#I dati di business si trovano in results. La tabella elenca i campi che un record può contenere; i valori che la piattaforma non mostra non vengono mai inventati.
| Campo | Significato |
|---|---|
id | ID univoco del record sulla piattaforma. È univoco solo all'interno di una piattaforma; gli ID possono ripetersi tra piattaforme diverse. |
url | Link al record sulla piattaforma. |
title | Titolo. null quando la piattaforma non prevede titoli (ad esempio post di solo testo). |
text | Testo del contenuto senza HTML, restituito per intero e mai troncato (su alcune piattaforme i risultati degli elenchi contengono solo un estratto; lo indicano le note sui campi della piattaforma). |
image_url | Link all'immagine. Le funzionalità con più immagini possono restituire un array image_urls. |
video_url | Mantiene il significato attribuito dalla piattaforma |
media_type | Mantiene il significato attribuito dalla piattaforma |
external_link | Mantiene il significato attribuito dalla piattaforma |
source_domain | Mantiene il significato attribuito dalla piattaforma |
reaction_count | Mantiene il significato attribuito dalla piattaforma |
repin_count | Mantiene il significato attribuito dalla piattaforma |
comment_count | Commenti. null significa non resi noti, non 0. |
share_count | Condivisioni. null significa non rese note, non 0. |
dominant_color | Mantiene il significato attribuito dalla piattaforma |
alt_text | Mantiene il significato attribuito dalla piattaforma |
posted_at | Data e ora di pubblicazione in formato ISO 8601, UTC (ad esempio 2026-08-07T12:34:56+00:00). Le stringhe non standard della piattaforma vengono passate così come sono, quindi esegui il parsing in modo difensivo. null significa che la piattaforma non le rende note. |
author_username | Username dell'autore (@handle), di solito utilizzabile negli URL. |
author_name | Nome visualizzato dell'autore. |
board_name | Mantiene il significato attribuito dalla piattaforma |
price | Prezzo come numero senza simbolo di valuta; vedi currency. |
platform | Identificativo della piattaforma di origine, uguale a platform nella richiesta (ad esempio xiaohongshu, tiktok). |
FAQ
#Quale link devo passare come url?
#Un link a un Pin il cui percorso contiene /pin/ e l'ID numerico del Pin, ad esempio https://www.pinterest.com/pin/140806234732511/. I link alle bacheche nella forma /username/board-name/ non sono Pin e non funzionano con Pin details; leggili con la funzionalità Pinterest Board details, che accetta il link della bacheca o il suo percorso relativo.
Cosa misura repin_count?
#Misura quante volte il Pin è stato salvato di nuovo, cioè ripinnato. È la principale metrica di Pinterest per misurare la diffusione dei contenuti. Leggilo insieme a reaction_count e comment_count: un Pin con molti repin e pochi commenti viene salvato per consultarlo in seguito più che per discuterne.
Dove manda le persone un Pin quando ci cliccano?
#external_link è l'indirizzo esterno a cui punta il Pin, e source_domain è il dominio della fonte del contenuto. Raggruppando i Pin per source_domain vedi verso quali siti un insieme di Pin indirizza le persone, sia che tu stia monitorando la presenza del tuo sito su Pinterest sia quella di un concorrente.
Errori e addebiti
#- 401
- Chiave mancante o non valida.
- 402
- Saldo insufficiente. Effettua prima una ricarica.
- 422
- Nome o valore del parametro non valido. Correggilo seguendo i suggerimenti dell'errore. Nessun addebito.
- 429
- Raggiunto il limite di richieste al minuto. Attendi il tempo indicato da Retry-After, poi riprova.
- 503
- Impossibile completare. L'importo trattenuto torna sul tuo saldo. Se l'esito è incerto, verificalo prima di riprovare.
- Risposta 200 vuota
- Nessun dato. Nessun addebito.
Riferimenti ufficiali
#Usati solo per verificare oggetti e terminologia. Non implicano alcuna autorizzazione o approvazione di EveryInfra da parte della piattaforma.
- Pinterest: i link ai rivenditori nei Pin prodotto ↗
La documentazione ufficiale indica che i Pin prodotto possono indirizzare gli utenti ai siti dei rivenditori e che alcuni Rich Pin sincronizzano i dettagli del prodotto. Questa pagina restituisce solo i campi dei Pin effettivamente recuperati e non garantisce inventario in tempo reale, funzionalità per effettuare ordini o dati sulle transazioni.
Verificato il 2026-09-04