API Pinterest Pin di una bacheca
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
Scorri i Pin salvati su una bacheca Pinterest, identificata da board_id, ad esempio pinterest/official-news. Ogni Pin include contenuti multimediali, link in uscita, autore e interazioni. Le sezioni private sono escluse e non è garantita la copertura dell'intera bacheca.
Invia POST https://api.everyinfra.com/api/v1/social con platform impostato su pinterest e action impostato su board_pins. 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 Pins on a board elenca i Pin salvati in una bacheca, dato il suo board_id, e restituisce per ogni Pin titolo e descrizione, immagine o video, link esterno e dominio di origine, numero di repin, reazioni e commenti, dominant_color, alt_text, autore e data di pubblicazione. Le bacheche sono l'unità di raccolta di Pinterest, quindi questa funzionalità ti dice cosa contiene una selezione curata: i brand controllano le proprie bacheche, chi studia le tendenze legge le mood board più influenti e i merchant vedono quali prodotti e siti raccoglie una bacheca.
board_id è la parte dell'indirizzo della bacheca dopo pinterest.com/, cioè lo username dell'account e il nome della bacheca, ad esempio pinterest/official-news; lo ricavi da ogni link a una bacheca nei risultati di Pinterest Boards, togliendo il dominio. source_domain sull'insieme delle righe mostra da quali siti attinge la bacheca, e dominant_color sull'insieme delle righe ne delinea la palette. Un comment_count o share_count null significa che il conteggio non è stato reso noto, non che è zero.
Prompt per l'AI
#Aiutami a scrivere uno script di raccolta dei dati con l'endpoint Pinterest Pin di una bacheca di EveryInfra (pinterest/board_pins).
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 board_pins, e inserisci i parametri in params.
- Parametri obbligatori:
- board_id: Identificatore della bacheca per board_pins: la parte username/board-name dell'URL della bacheca dopo pinterest.com/, ad esempio pinterest/official-news. Ogni bacheca nei risultati di boards ha un url.
- Parametri facoltativi:
- limit: Numero massimo di righe da restituire in questa chiamata: un intero da 1 a 50. Se lo ometti, viene applicato il valore predefinito; una chiamata può restituire meno righe. (predefinito: 20)
- Restituisce un elenco di record. Campi principali di ogni record: 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": "board_pins",
"params": {
"board_id": "pinterest/official-news"
}
}
- 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ì | board_pins | Identificativo della funzionalità, valore fisso. |
board_id | body.params | string | Sì | - | Identificatore della bacheca per board_pins: la parte username/board-name dell'URL della bacheca dopo pinterest.com/, ad esempio pinterest/official-news. Ogni bacheca nei risultati di boards ha un url; togli il dominio per ottenere questo valore. |
limit | body.params | integer (1–50) | No | 20 | Numero massimo di righe da restituire in questa chiamata: un intero da 1 a 50. Se lo ometti, viene applicato il valore predefinito; una chiamata può restituire meno righe. I valori più alti restituiscono 422 prima di qualsiasi addebito. |
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": "board_pins",
"params": {
"board_id": "pinterest/official-news"
}
}'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": "board_pins", "results": [ { "id": "•••", "url": "https://www.pinterest.com/pin/424605071112831904/", "title": "", "text": "Introducing the Workshop: A creative studio for bringing Pinterest ideas to life", "image_url": "https://i.pinimg.com/originals/32/68/65/3268658fe7973644e6e6e5be15266517.jpg", "media_type": "image", "external_link": "https://blog.pinterest.com/en/introducing-workshop-creative-studio-bringing-pinterest-ideas-life", "source_domain": "blog.pinterest.com", "repin_count": 62, "dominant_color": "#c4a285", "alt_text": "a room filled with lots of yellow stools next to a table and shelves on the wall", "author_username": "•••", "author_name": "•••", "board_name": "Official news", "platform": "pinterest" }, { "id": "•••", "url": "https://www.pinterest.com/pin/424605071093691246/", "title": "", "text": "More goodies for the iOS app, via the Official Pinterest Blog", "image_url": "https://i.pinimg.com/originals/ae/cb/6f/aecb6f2fa70649bc9625e061b1f53ed2.jpg", "media_type": "image", "external_link": "http://blog.pinterest.com/post/101709303399/more-goodies-for-the-ios-app", "source_domain": "blog.pinterest.com", "repin_count": 31, "dominant_color": "#f7f6f6", "alt_text": "two iphones with food on them, one showing blueberry pancakes and the other showing chocolate chip cookies", "author_username": "•••", "author_name": "•••", "board_name": "Official news", "platform": "pinterest" } ], "count": 20, "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
#Dove trovo un board_id?
#Nell'indirizzo della bacheca: è la parte dopo pinterest.com/, cioè lo username dell'account seguito dal nome della bacheca, ad esempio pinterest/official-news. Per raccoglierli per un account, elencane le bacheche con Pinterest Boards e togli il dominio da ogni link. Il solo nome visualizzato di una bacheca non basta.
Da quali siti attinge una bacheca?
#Raggruppa le righe per source_domain, il dominio della fonte del contenuto di ogni Pin, e guarda external_link per la pagina esatta a cui porta ogni Pin. In una bacheca di shopping o di ispirazione, questo mostra su quali rivenditori ed editori si basa di più chi la cura.
Posso ricavare la palette di colori di una bacheca dai risultati?
#Sì. Il dominant_color di ogni riga è il colore principale del Pin come valore esadecimale, pronto per l'analisi visiva. Conta i colori su tutta la bacheca per vederne la palette, e abbinali a image_url e alt_text quando vuoi verificare come i colori si legano ai soggetti mostrati.
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: organizzare i Pin per bacheca senza confonderli con le sezioni ↗
La documentazione ufficiale indica che i Pin si possono inserire in sezioni all'interno di una bacheca. Qui `board_id` continua a indicare solo la bacheca; i tutorial ufficiali non forniscono a questo endpoint funzioni di conversione degli ID, né implicano che siano disponibili parametri di query per le sezioni.
Verificato il 2026-09-04