API di Pinterest
Trova pin, profili utente e bacheche di Pinterest tramite parole chiave e URL per esaminare immagini, video e fonti esterne.
Interroga URL di pin specifici o identificatori di bacheche, senza usare gli URL delle bacheche per cercare i pin.
Invia POST https://api.everyinfra.com/api/v1/social con platform impostato su pinterest e action impostato sul nome di una funzionalità dell'elenco qui sotto, ad esempio search.
- 7 funzionalità
- $1.39 per 1.000 richieste
- Nessun addebito per chiamate non riuscite o risultati vuoti
Disponibilità della piattaforma
- Operatività nelle ultime 24 ore
- Normale
Ultimi 30 giorni
Funzionalità disponibili
Ogni azione di Pinterest: cosa fa, quanto costa e come ha funzionato nelle ultime 24 ore. Apri un'azione per vederne parametri, campi della risposta ed esempi di codice.
| Funzionalità | Cosa fa | Per 1.000Righe vuote: $1.39 | Stato nelle ultime 24 ore · Tutto regolare |
|---|---|---|---|
Ricercasearch | Cerca Pin su Pinterest per parola chiave, tra tutti i Pin o solo tra i Pin video, con immagine, dominio di origine, colore dominante, reazioni e dettagli su bacheca e autore del Pin. | Normale | |
Profiliprofile | Cerca un account Pinterest per handle, con o senza @, per ottenere bio, sito web, verifica, indicatore di privacy e numero di follower, Pin, bacheche e video. | Normale | |
Post dell'utenteuser_posts | Estrai i Pin pubblicati da un account Pinterest. | Normale | |
Dettagli del Pinpin | Recupera un Pin di Pinterest da un link /pin/ con il suo ID numerico. | Normale | |
Bachecheboards | Elenca le bacheche di proprietà di un account Pinterest, con descrizione, immagine di copertina, numero di Pin e sezioni, follower, impostazione di privacy e indicatore di bacheca collaborativa. | Normale | |
Pin di una bachecaboard_pins | Scorri i Pin salvati su una bacheca Pinterest, identificata da board_id, ad esempio pinterest/official-news. | Normale | |
Dettagli della bachecaboard_detail | Controlla una bacheca Pinterest dal suo url. | Normale |
Cosa accetta ogni azione di API di Pinterest?
Ogni risposta qui sotto associa un'azione richiamabile ai suoi input reali. Il significato dei parametri e i valori ammessi dipendono dall'azione: un nome familiare non ha lo stesso significato su tutte le piattaforme.
Le fonti ufficiali sono linkate solo per chiarire il termine della piattaforma accanto a cui compaiono. Non implicano autorizzazione o approvazione da parte della piattaforma e le funzionalità del sito ufficiale non fanno parte dell'API di EveryInfra, a meno che questa pagina non le elenchi.
Consegna Sync per ogni azione.
| Azione | Obbligatori | Facoltativi | Limite | Per 1.000Righe vuote: $1.39 | Campi della risposta |
|---|---|---|---|---|---|
searchRicerca Cerca Pin su Pinterest per parola chiave, tra tutti i Pin o solo tra i Pin video, con immagine, dominio di origine, colore dominante, reazioni e dettagli su bacheca e autore del Pin. Bacheche e creator non vengono restituiti, e un Pin non concede alcun diritto sulla sua immagine né garantisce l'affidabilità del sito collegato. | keyword | content_type | Valori del catalogo: defaultLimit=20, maxLimit=50. Per alcune azioni limit può controllare le pagine o l'espansione per elemento padre, quindi non è sempre un numero finale di righe. | id · url · title · text · image_url · reaction_count · source_domain · dominant_color · posted_at · author_username · author_name · author_follower_count · board_name · platform | |
profileProfili Cerca un account Pinterest per handle, con o senza @, per ottenere bio, sito web, verifica, indicatore di privacy e numero di follower, Pin, bacheche e video. Gli URL dei profili non sono accettati, e un sito web indicato non dimostra la proprietà del dominio né rivela le bacheche segrete. | username | — | — | user_id · username · name · bio · avatar_url · follower_count · following_count · pin_count · board_count · video_count · website · is_verified · is_private · created_at · platform | |
user_postsPost dell'utente Estrai i Pin pubblicati da un account Pinterest. Immagini, video e link in uscita restano separati, ognuno con numero di repin, reazioni e commenti e la sua bacheca. La copertura di tutte le bacheche e dei Pin meno recenti non è garantita. | username | — | Valori del catalogo: defaultLimit=20, maxLimit=50. Per alcune azioni limit può controllare le pagine o l'espansione per elemento padre, quindi non è sempre un numero finale di righe. | id · url · title · text · image_url · video_url · media_type · external_link · source_domain · reaction_count · repin_count · comment_count · share_count · dominant_color · alt_text · posted_at · author_username · author_name · board_name · price · platform | |
pinDettagli del Pin 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. | url | — | — | id · url · title · text · image_url · video_url · media_type · external_link · source_domain · reaction_count · repin_count · comment_count · share_count · dominant_color · alt_text · posted_at · author_username · author_name · board_name · price · platform | |
boardsBacheche Elenca le bacheche di proprietà di un account Pinterest, con descrizione, immagine di copertina, numero di Pin e sezioni, follower, impostazione di privacy e indicatore di bacheca collaborativa. Una bacheca collaborativa non rivela tutti i suoi membri né contenuti privati. | username | — | Valori del catalogo: defaultLimit=20, maxLimit=50. Per alcune azioni limit può controllare le pagine o l'espansione per elemento padre, quindi non è sempre un numero finale di righe. | id · name · url · description · pin_count · section_count · follower_count · cover_image_url · is_collaborative · privacy · owner_username · owner_name · created_at · platform | |
board_pinsPin di una bacheca Scorri i Pin salvati su una bacheca Pinterest, identificata da | board_id | — | Valori del catalogo: defaultLimit=20, maxLimit=50. Per alcune azioni limit può controllare le pagine o l'espansione per elemento padre, quindi non è sempre un numero finale di righe. | id · url · title · text · image_url · video_url · media_type · external_link · source_domain · reaction_count · repin_count · comment_count · share_count · dominant_color · alt_text · posted_at · author_username · author_name · board_name · price · platform | |
board_detailDettagli della bacheca Controlla una bacheca Pinterest dal suo | url | — | — | id · name · url · description · pin_count · section_count · follower_count · cover_image_url · is_collaborative · privacy · owner_username · owner_name · created_at · platform |
Cosa significano i parametri search di API di Pinterest?
Cerca Pin su Pinterest per parola chiave, tra tutti i Pin o solo tra i Pin video, con immagine, dominio di origine, colore dominante, reazioni e dettagli su bacheca e autore del Pin. Bacheche e creator non vengono restituiti, e un Pin non concede alcun diritto sulla sua immagine né garantisce l'affidabilità del sito collegato.
Riferimento API completo: parametri, esempi di codice, esempio di risposta e statokeywordObbligatorio- Specifica termini di ricerca o temi di ispirazione per l'azione search. La struttura delle entità restituite dipende dal content_type selezionato.
content_typeFacoltativo- Filtra i risultati di ricerca per tipo di pin: all_pins_visual_posts per tutti i pin (non solo quelli con immagini) o videos_video_pins solo per i pin video. La ricerca restituisce solo pin, non bacheche né creator.Valori ammessi:
all_pins_visual_postsvideos_video_pinsPinterest: Pin immagine, Pin video e Pin prodotto — Pinterest definisce i Pin come segnalibri visivi e distingue formati come immagine, video e prodotto. Questa definizione serve a spiegare gli oggetti di contenuto e non significa che la ricerca restituisca tutti gli oggetti ufficiali o tutti i campi media; i conflitti sul tipo di ricerca in questa pagina restano soggetti alle limitazioni indicate sopra. · Verificato
Cosa significano i parametri profile di API di Pinterest?
Cerca un account Pinterest per handle, con o senza @, per ottenere bio, sito web, verifica, indicatore di privacy e numero di follower, Pin, bacheche e video. Gli URL dei profili non sono accettati, e un sito web indicato non dimostra la proprietà del dominio né rivela le bacheche segrete.
Riferimento API completo: parametri, esempi di codice, esempio di risposta e statousernameObbligatorio- Specifica l'handle dell'utente Pinterest per le azioni profile, user_posts e boards, con o senza @ iniziale. Gli URL web completi del profilo non sono accettati.
Cosa significano i parametri user_posts di API di Pinterest?
Estrai i Pin pubblicati da un account Pinterest. Immagini, video e link in uscita restano separati, ognuno con numero di repin, reazioni e commenti e la sua bacheca. La copertura di tutte le bacheche e dei Pin meno recenti non è garantita.
Riferimento API completo: parametri, esempi di codice, esempio di risposta e statousernameObbligatorio- Specifica l'handle dell'utente Pinterest per le azioni profile, user_posts e boards, con o senza @ iniziale. Gli URL web completi del profilo non sono accettati.Pinterest: i Pin salvati non sono necessariamente contenuti originali dell'account — La documentazione ufficiale spiega che i Pin immagine si possono creare caricando immagini o salvando immagini da siti esterni, e che i Pin salvati da siti esterni conservano il link al sito originale. I Pin associati a un account non possono essere considerati automaticamente opere originali, e la verifica della fonte non sostituisce i permessi d'uso dei contenuti. · Verificato
Cosa significano i parametri pin di API di Pinterest?
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.
Riferimento API completo: parametri, esempi di codice, esempio di risposta e statourlObbligatorio- 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.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
Cosa significano i parametri boards di API di Pinterest?
Elenca le bacheche di proprietà di un account Pinterest, con descrizione, immagine di copertina, numero di Pin e sezioni, follower, impostazione di privacy e indicatore di bacheca collaborativa. Una bacheca collaborativa non rivela tutti i suoi membri né contenuti privati.
Riferimento API completo: parametri, esempi di codice, esempio di risposta e statousernameObbligatorio- Specifica l'handle dell'utente Pinterest per le azioni profile, user_posts e boards, con o senza @ iniziale. Gli URL web completi del profilo non sono accettati.Pinterest: la gerarchia tra bacheche e sezioni — Pinterest usa le sezioni per organizzare i Pin all'interno di una bacheca. Per questo `section_count` non va interpretato come un numero di bacheche; il riferimento ai tutorial sulla creazione delle sezioni non implica che questo endpoint possa creare, spostare o modificare contenuti. · Verificato
Cosa significano i parametri board_pins di API di Pinterest?
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.
board_idObbligatorio- 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.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
Cosa significano i parametri board_detail di API di Pinterest?
Controlla una bacheca Pinterest dal suo url. Ottieni proprietario, descrizione, copertina, privacy, indicatore di bacheca collaborativa e numero di Pin, sezioni e follower. I Pin non sono inclusi. Li fornisce board_pins.
urlObbligatorio- 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.Pinterest: le regole di visibilità delle bacheche segrete — La documentazione ufficiale specifica che le bacheche segrete sono visibili solo al proprietario e ai collaboratori invitati. Conoscere il link o l'ID di una bacheca non dà il permesso di accedervi, e questa pagina non fornisce funzioni per aggirare le impostazioni di segretezza. · Verificato
Come usare l'API di Pinterest
- 01Scegli un'azione della piattaforma dal catalogo pubblico.
- 02Invia piattaforma, azione e parametri obbligatori a POST /api/v1/social.
- 03Leggi il risultato dalla risposta. Per un'azione asincrona, interroga periodicamente il job ID restituito.
- 04Salva i campi della risposta che servono alla tua applicazione.
curl -X POST https://api.everyinfra.com/api/v1/social \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"platform":"pinterest","action":"search","params":{"keyword":"<keyword>"}}'
Domande sull'API di Pinterest
Cosa posso ottenere con l'API di Pinterest?
Imposta platform su pinterest. Il catalogo attuale elenca ricerca, profili, post dell'utente, dettagli del Pin, bacheche e more. Questi nomi di azione identificano oggetti o viste diversi di Pinterest; non sono modalità di ricerca intercambiabili.
Quale input avvia la richiesta search di Pinterest?
Specifica termini di ricerca o temi di ispirazione per l'azione search. La struttura delle entità restituite dipende dal content_type selezionato. Invialo come keyword all'interno di params.
Quali campi può restituire search di Pinterest?
Il suo schema dichiarato include title, text, image_url e reaction_count. Un campo dichiarato può comunque mancare in un singolo record, e ogni altra azione ha il proprio elenco di campi.
Tutte le azioni di Pinterest rispondono subito?
Le azioni indicate come asincrone restituiscono un job ID da interrogare periodicamente. Tutte le altre azioni possono essere eseguite anche in modo asincrono: aggiungi "mode": "async" al corpo della richiesta per ricevere subito un job ID, utile per task lenti o limiti elevati. Il catalogo attuale contiene consegna sync.