API di Facebook

Trova post, profili, commenti, inserzioni e annunci di Marketplace pubblici tramite parole chiave o URL per le ricerche sui social media.

Alcuni contenuti richiedono task asincroni per essere ottenuti, e i termini di ricerca distinguono tra parole chiave, inserzioni e articoli di Marketplace.

Invia POST https://api.everyinfra.com/api/v1/social con platform impostato su facebook e action impostato sul nome di una funzionalità dell'elenco qui sotto, ad esempio search.

  • 16 funzionalità
  • Da $0.88 per 1.000 richieste
  • Nessun addebito per chiamate non riuscite o risultati vuoti
  • Operatività nelle ultime 24 ore 96%

Disponibilità della piattaforma

Operatività nelle ultime 24 ore
96%
Buono

Ultimi 30 giorni

Funzionalità disponibili

Ogni azione di Facebook: 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 faPer 1.000Operatività nelle ultime 24 ore
RicercasearchCerca post Facebook tramite keyword e ottieni per ogni post testo, autore, like, commenti, condivisioni e ora di pubblicazione, con un intervallo di date facoltativo.$16 per 1.000 richiesteOgni 10 righe valgono una chiamataBuono · operatività 99%
DettagliprofileOttieni una Pagina o un profilo pubblico di Facebook dal suo url.$2.78 per 1.000 richiesteNormale
Post dell'utenteuser_postsElenca i post di una Pagina o di un account Facebook all'url indicato, ciascuno con testo, autore, ora di pubblicazione e numero di like, commenti e condivisioni.$2.78 per 1.000 richiesteNormale
Dettagli del postpostRecupera un post Facebook dal suo url con testo, autore, ora di pubblicazione e numero di like, commenti e condivisioni.$1.39 per 1.000 richiesteNormale
CommenticommentsEstrai i commenti a un post Facebook dal suo url.$2.78 per 1.000 richiesteNormale
FollowerfollowersControlla il numero di follower, account seguiti, post e like di un account o di una Pagina Facebook tramite username.$1.39 per 1.000 richiesteNormale
Annunci pubblicitariadsTrova inserzioni nella Libreria inserzioni di Facebook tramite keyword o URL della Libreria inserzioni.$1.39 per 1.000 richiesteBuono · operatività 100%
Post del gruppogroup_postsLeggi i post di un gruppo Facebook tramite url o identificatore del gruppo.$1.39 per 1.000 richiesteNormale
MarketplacemarketplaceSfoglia gli annunci di Facebook Marketplace per la keyword di un oggetto in una città.$1.39 per 1.000 richiesteNormale
RecensionireviewsRaccogli consigli e recensioni da una Pagina Facebook tramite url, con testo, consiglia o non consiglia, valutazione se presente, autore e ora di pubblicazione.$1.39 per 1.000 richiesteNormale
Ricerca inserzionistiadvertiser_searchTrova le Pagine Facebook che fanno pubblicità con un brand o un nome di inserzionista nella Libreria inserzioni, fino a 15 per chiamata.$0.88 per 1.000 richiesteNormale
Dettagli dell'annuncioad_detailApri un'inserzione nella Libreria inserzioni di Facebook dal suo link o dall'ID della Libreria.$0.96 per 1.000 richiesteNormale
Ricerca eventievents_searchCerca eventi Facebook pubblici tramite keyword, ad esempio music festival.$0.96 per 1.000 richiesteTemporaneamente non disponibile
Dettagli della scheda prodotto del Marketplacemarketplace_itemLeggi un annuncio di Facebook Marketplace dal suo link o ID numerico.$0.96 per 1.000 richiesteTemporaneamente non disponibile
Eventi della Paginapage_eventsElenca gli eventi, futuri e passati, ospitati da una Pagina Facebook pubblica, partendo dal link della Pagina.$0.96 per 1.000 richiesteTemporaneamente non disponibile
Trascrizioni dei post videopost_transcriptTrascrivi il parlato di un video, Reel o post video pubblico di Facebook, dal suo link.$0.96 per 1.000 richiesteTemporaneamente non disponibile

Cosa accetta ogni azione di API di Facebook?

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.

AzioneObbligatoriFacoltativiConsegnaLimitePer 1.000Campi della risposta
search

Ricerca

Cerca post Facebook tramite keyword e ottieni per ogni post testo, autore, like, commenti, condivisioni e ora di pubblicazione, con un intervallo di date facoltativo. content_type ordina per più recenti o più popolari anziché filtrare i media, e i messaggi privati non vengono cercati.

keywordcontent_type, since, untilConsegna SyncValori del catalogo: defaultLimit=10, maxLimit=200. Per alcune azioni limit può controllare le pagine o l'espansione per elemento padre, quindi non è sempre un numero finale di righe.$16 per 1.000 richiesteOgni 10 righe valgono una chiamataid · url · text · author_name · author_username · author_id · author_url · author_avatar_url · media · reactions · view_count · link · group_name · is_paid_partnership · like_count · comment_count · share_count · posted_at · platform
profile

Dettagli

Ottieni una Pagina o un profilo pubblico di Facebook dal suo url. Include categoria, bio, like, follower, badge di verifica ed eventuali contatti mostrati. Telefono ed email sono solo quelli visualizzati nella pagina. Non verificano l'identità né ne autorizzano l'uso.

url—Consegna Async—$2.78 per 1.000 richiesteid · name · url · bio · category · like_count · follower_count · is_verified · phone · email · website · rating · rating_scale · avatar_url · platform
user_posts

Post dell'utente

Elenca i post di una Pagina o di un account Facebook all'url indicato, ciascuno con testo, autore, ora di pubblicazione e numero di like, commenti e condivisioni. I risultati non coincidono necessariamente con l'intero diario.

url—Consegna AsyncValori del catalogo: defaultLimit=10, maxLimit=50. Per alcune azioni limit può controllare le pagine o l'espansione per elemento padre, quindi non è sempre un numero finale di righe.$2.78 per 1.000 richiesteid · url · text · author_name · author_username · author_id · author_url · author_avatar_url · media · reactions · view_count · link · group_name · is_paid_partnership · like_count · comment_count · share_count · posted_at · platform
post

Dettagli del post

Recupera un post Facebook dal suo url con testo, autore, ora di pubblicazione e numero di like, commenti e condivisioni. Commenti, reazioni dettagliate e contenuti privati non sono inclusi. Usa comments per la discussione.

url—Consegna Sync—$1.39 per 1.000 richiesteid · url · text · author_name · author_username · author_id · author_url · author_avatar_url · media · reactions · view_count · link · group_name · is_paid_partnership · like_count · comment_count · share_count · posted_at · platform
comments

Commenti

Estrai i commenti a un post Facebook dal suo url. Ogni commento include autore, ID autore, like, numero di risposte, ora di pubblicazione e permalink. Le righe di risposta riutilizzano l'ID del gruppo padre, quindi ricostruisci le discussioni con depth e reply_to_id. Un albero completo non è garantito.

url—Consegna AsyncValori del catalogo: defaultLimit=10, maxLimit=50. Per alcune azioni limit può controllare le pagine o l'espansione per elemento padre, quindi non è sempre un numero finale di righe.$2.78 per 1.000 richiesteid · text · author_name · author_username · depth · reply_to_id · comment_url · author_id · author_url · like_count · reply_count · posted_at · platform
followers

Follower

Controlla il numero di follower, account seguiti, post e like di un account o di una Pagina Facebook tramite username. Un flag di precisione segnala i valori approssimativi. Restituisce solo i totali, non un elenco dei singoli follower.

usernamechannelConsegna Sync—$1.39 per 1.000 richiesteid · username · url · follower_count · following_count · post_count · like_count · connection_count · precision · platform
ads

Annunci pubblicitari

Trova inserzioni nella Libreria inserzioni di Facebook tramite keyword o URL della Libreria inserzioni. Ottieni testo dell'inserzione, invito all'azione, landing page, date di pubblicazione, posizionamenti e inserzionista. Restringi per paese e status. Spesa, impression, targeting e conversioni non sono inclusi.

keywordcountry, statusConsegna SyncValori del catalogo: defaultLimit=20, maxLimit=200. Per alcune azioni limit può controllare le pagine o l'espansione per elemento padre, quindi non è sempre un numero finale di righe.$1.39 per 1.000 richiesteid · url · text · title · cta_text · link_url · is_active · started_at · ended_at · platforms · variant_count · advertiser_id · advertiser_name · advertiser_url · advertiser_likes · image_url · platform
group_posts

Post del gruppo

Leggi i post di un gruppo Facebook tramite url o identificatore del gruppo. Ottieni testo, autore, ora di pubblicazione e numero di like, commenti e condivisioni. sort sceglie i post principali o l'attività recente. L'attività recente segue l'attività, non la data di creazione. La copertura completa non è garantita.

urlsortConsegna SyncValori del catalogo: defaultLimit=20, maxLimit=200. Per alcune azioni limit può controllare le pagine o l'espansione per elemento padre, quindi non è sempre un numero finale di righe.$1.39 per 1.000 richiesteid · url · text · posted_at · like_count · comment_count · share_count · author_id · author_name · author_url · group_url · platform
marketplace

Marketplace

Sfoglia gli annunci di Facebook Marketplace per la keyword di un oggetto in una città. Ottieni prezzo, valuta, città, stato, condizioni, immagine e ora di pubblicazione. location accetta un percorso di città come nyc, il valore predefinito, non un indirizzo. La disponibilità non è confermata.

keywordlocationConsegna SyncValori del catalogo: defaultLimit=20, maxLimit=200. Per alcune azioni limit può controllare le pagine o l'espansione per elemento padre, quindi non è sempre un numero finale di righe.$1.39 per 1.000 richiesteid · url · name · price · currency · city · state · condition · image_url · posted_at · platform
reviews

Recensioni

Raccogli consigli e recensioni da una Pagina Facebook tramite url, con testo, consiglia o non consiglia, valutazione se presente, autore e ora di pubblicazione. Facebook usa consiglia o non consiglia al posto delle stelle, quindi una valutazione mancante non annulla un consiglio.

url—Consegna SyncValori del catalogo: defaultLimit=20, maxLimit=200. Per alcune azioni limit può controllare le pagine o l'espansione per elemento padre, quindi non è sempre un numero finale di righe.$1.39 per 1.000 richiesteid · url · text · is_recommended · rating · rating_scale · posted_at · like_count · comment_count · author_id · author_name · author_url · platform
advertiser_search

Ricerca inserzionisti

Trova le Pagine Facebook che fanno pubblicità con un brand o un nome di inserzionista nella Libreria inserzioni, fino a 15 per chiamata. Ogni Pagina include ID, nome, username, categoria, flag di verifica, like della Pagina e l'account Instagram collegato con il suo numero di follower. Una ricerca per nike mostra per prima Nike (ID Pagina 15087023444). Non c'è paginazione.

keyword—Consegna SyncValori del catalogo: defaultLimit=15, maxLimit=15. Per alcune azioni limit può controllare le pagine o l'espansione per elemento padre, quindi non è sempre un numero finale di righe. Un limit più alto è accettato e ridotto a 15.$0.88 per 1.000 richiesteid · name · username · url · category · avatar_url · page_like_count · is_verified · instagram_username · instagram_follower_count · instagram_verified · country · platform
ad_detail

Dettagli dell'annuncio

Apri un'inserzione nella Libreria inserzioni di Facebook dal suo link o dall'ID della Libreria. Ottieni se è ancora attiva, date di inizio e fine, testo, titolo, link e invito all'azione, formato di visualizzazione, posizionamenti in cui è stata pubblicata, immagini o video, tutte le varianti creative, e ID, nome, like e categorie della Pagina dell'inserzionista. Spesa, copertura e targeting non sono inclusi nel risultato.

url—Consegna Sync—$0.96 per 1.000 richiesteid · url · is_active · started_at · ended_at · text · title · caption · link_url · link_description · cta_text · display_format · platforms · media · creatives · variant_count · advertiser_id · advertiser_name · advertiser_url · advertiser_likes · advertiser_avatar_url · advertiser_categories · platform
events_search

Ricerca eventi

Cerca eventi Facebook pubblici tramite keyword, ad esempio music festival. Ogni evento include nome, ora di inizio, data come la mostra Facebook, luogo, flag online, se si è già svolto, numero di partecipanti e interessati, testo del prezzo dei biglietti quando presente e immagine di copertina. Sono inclusi gli eventi passati. Circa 5 per pagina; vai avanti con next_page_token.

keywordpage_tokenConsegna SyncOgni chiamata restituisce una pagina di massimo 5 righe. Il numero di righe varia da pagina a pagina, quindi una pagina più corta non indica la fine. Per la pagina successiva, passa come page_token il next_page_token di primo livello della risposta; fermati quando non è presente. limit è accettato ma non ha effetto.$0.96 per 1.000 richiesteid · url · name · starts_at · date_text · place_name · place_id · is_online · is_past · going_count · interested_count · price_text · image_url · next_page_token · platform
marketplace_item

Dettagli della scheda prodotto del Marketplace

Leggi un annuncio di Facebook Marketplace dal suo link o ID numerico. Ottieni titolo, descrizione, prezzo e prezzo originale, valuta, condizioni, attributi dell'oggetto, posizione con coordinate, data dell'annuncio, flag venduto e in sospeso, opzioni di spedizione e consegna, foto, oltre a nome, valutazione, numero di valutazioni e data di iscrizione del venditore.

url—Consegna Sync—$0.96 per 1.000 richiesteid · url · title · text · price · price_text · original_price_text · currency · condition · attributes · location · latitude · longitude · posted_at · is_sold · is_pending · is_shipping_offered · delivery_types · category_id · image_urls · seller_id · seller_name · seller_rating · seller_rating_count · seller_joined_at · platform
page_events

Eventi della Pagina

Elenca gli eventi, futuri e passati, ospitati da una Pagina Facebook pubblica, partendo dal link della Pagina. Ogni evento include nome, ora di inizio, luogo, città, organizzatore e flag online, passato e annullato. Fino a 10 per pagina e il numero varia; vai avanti con next_page_token. Una Pagina che non ospita eventi restituisce un elenco vuoto.

urlpage_tokenConsegna SyncOgni chiamata restituisce una pagina di massimo 10 righe. Il numero di righe varia da pagina a pagina, quindi una pagina più corta non indica la fine. Per la pagina successiva, passa come page_token il next_page_token di primo livello della risposta; fermati quando non è presente. limit è accettato ma non ha effetto.$0.96 per 1.000 richiesteid · url · name · starts_at · date_text · place_name · city · host_name · is_online · is_past · is_canceled · next_page_token · platform
post_transcript

Trascrizioni dei post video

Trascrivi il parlato di un video, Reel o post video pubblico di Facebook, dal suo link. Ottieni la trascrizione e la durata del video in secondi. Un video in cui nessuno parla viene restituito senza text.

url—Consegna Sync—$0.96 per 1.000 richiesteid · url · text · duration_seconds · duration_sec · platform

Cosa significano i parametri search di API di Facebook?

Cerca post Facebook tramite keyword e ottieni per ogni post testo, autore, like, commenti, condivisioni e ora di pubblicazione, con un intervallo di date facoltativo. content_type ordina per più recenti o più popolari anziché filtrare i media, e i messaggi privati non vengono cercati.

Riferimento API completo: parametri, esempi di codice, esempio di risposta e stato
keywordObbligatorio
Specifica la query di ricerca per endpoint distinti della piattaforma. Per search, cerca nei post pubblici; per ads, accetta parole chiave degli annunci o URL diretti di Ad Library e delle Pagine; per marketplace, accetta termini di ricerca di articoli o URL di ricerca completi di Marketplace. Ogni azione interroga un dataset diverso e non restituisce gli stessi risultati con nomi di campo diversi.
content_typeFacoltativo
Ordina i risultati dell'azione search con i valori consentiti latest per i post più recenti o most_popular per i post popolari. Nonostante il nome, content_type funziona come criterio di ordinamento e non filtra per formato dei contenuti, come immagini o video.
Valori ammessi:latestmost_popular
Facebook: limiti dei post pubblici e delle informazioni pubbliche — La documentazione di assistenza di Facebook definisce la visibilità delle condivisioni pubbliche, dei post delle Pagine e dei commenti ai post pubblici. Questo chiarisce gli oggetti a cui si rivolge la ricerca; non avalla i valori di ordinamento di `content_type` né dimostra che le informazioni visibili pubblicamente siano autorizzate per la raccolta automatizzata. · Verificato
sinceFacoltativo
Filtra i post pubblicati a partire da questa data di inizio per l'azione search; è consigliato il formato YYYY-MM-DD. Insieme a until definisce l'intervallo di date della query; non filtra i periodi di erogazione delle inserzioni pubblicitarie né le date di creazione dei commenti.
untilFacoltativo
Filtra i post pubblicati fino a questa data di fine per l'azione search; è consigliato il formato YYYY-MM-DD. Insieme a since definisce l'intervallo di date della query; non controlla le date di scadenza delle inserzioni pubblicitarie.

Cosa significano i parametri profile di API di Facebook?

Ottieni una Pagina o un profilo pubblico di Facebook dal suo url. Include categoria, bio, like, follower, badge di verifica ed eventuali contatti mostrati. Telefono ed email sono solo quelli visualizzati nella pagina. Non verificano l'identità né ne autorizzano l'uso.

Riferimento API completo: parametri, esempi di codice, esempio di risposta e stato
urlObbligatorio
Specifica l'URL di destinazione corrispondente all'azione richiesta. Usa URL di Pagine pubbliche per profile e user_posts, URL di post per post e comments, URL di pagine di gruppi o identificatori di gruppo per group_posts e URL di pagine aziendali per reviews (che aggiunge /reviews). Gli URL Facebook non sono intercambiabili tra azioni diverse.
Documentazione ufficiale di Facebook: visibilità pubblica dei profili delle Pagine, dei post e dei commenti — La documentazione ufficiale di Meta tratta i dettagli pubblici di Pagine, profili, post e commenti; questa definizione di visibilità non garantisce che ogni URL sia leggibile, che ogni campo venga restituito né che questo endpoint disponga di un'autorizzazione di accesso di Meta. · Verificato
Documentazione ufficiale di Meta: la raccolta automatizzata dei dati richiede un'autorizzazione preventiva — Meta afferma esplicitamente che la raccolta automatizzata dei dati di Facebook senza autorizzazione preventiva viola i suoi termini, anche per i dati visibili pubblicamente. Citare fonti autorevoli non costituisce prova di autorizzazione alla raccolta o al riutilizzo dei dati della piattaforma. · Verificato

Cosa significano i parametri user_posts di API di Facebook?

Elenca i post di una Pagina o di un account Facebook all'url indicato, ciascuno con testo, autore, ora di pubblicazione e numero di like, commenti e condivisioni. I risultati non coincidono necessariamente con l'intero diario.

Riferimento API completo: parametri, esempi di codice, esempio di risposta e stato
urlObbligatorio
Specifica l'URL di destinazione corrispondente all'azione richiesta. Usa URL di Pagine pubbliche per profile e user_posts, URL di post per post e comments, URL di pagine di gruppi o identificatori di gruppo per group_posts e URL di pagine aziendali per reviews (che aggiunge /reviews). Gli URL Facebook non sono intercambiabili tra azioni diverse.
Documentazione ufficiale di Facebook: visibilità pubblica dei profili delle Pagine, dei post e dei commenti — La documentazione ufficiale di Meta tratta i dettagli pubblici di Pagine, profili, post e commenti; questa definizione di visibilità non garantisce che ogni URL sia leggibile, che ogni campo venga restituito né che questo endpoint disponga di un'autorizzazione di accesso di Meta. · Verificato
Documentazione ufficiale di Meta: la raccolta automatizzata dei dati richiede un'autorizzazione preventiva — Meta afferma esplicitamente che la raccolta automatizzata dei dati di Facebook senza autorizzazione preventiva viola i suoi termini, anche per i dati visibili pubblicamente. Citare fonti autorevoli non costituisce prova di autorizzazione alla raccolta o al riutilizzo dei dati della piattaforma. · Verificato

Cosa significano i parametri post di API di Facebook?

Recupera un post Facebook dal suo url con testo, autore, ora di pubblicazione e numero di like, commenti e condivisioni. Commenti, reazioni dettagliate e contenuti privati non sono inclusi. Usa comments per la discussione.

Riferimento API completo: parametri, esempi di codice, esempio di risposta e stato
urlObbligatorio
Specifica l'URL di destinazione corrispondente all'azione richiesta. Usa URL di Pagine pubbliche per profile e user_posts, URL di post per post e comments, URL di pagine di gruppi o identificatori di gruppo per group_posts e URL di pagine aziendali per reviews (che aggiunge /reviews). Gli URL Facebook non sono intercambiabili tra azioni diverse.
Documentazione ufficiale di Facebook: visibilità pubblica dei profili delle Pagine, dei post e dei commenti — La documentazione ufficiale di Meta tratta i dettagli pubblici di Pagine, profili, post e commenti; questa definizione di visibilità non garantisce che ogni URL sia leggibile, che ogni campo venga restituito né che questo endpoint disponga di un'autorizzazione di accesso di Meta. · Verificato
Documentazione ufficiale di Meta: la raccolta automatizzata dei dati richiede un'autorizzazione preventiva — Meta afferma esplicitamente che la raccolta automatizzata dei dati di Facebook senza autorizzazione preventiva viola i suoi termini, anche per i dati visibili pubblicamente. Citare fonti autorevoli non costituisce prova di autorizzazione alla raccolta o al riutilizzo dei dati della piattaforma. · Verificato

Cosa significano i parametri comments di API di Facebook?

Estrai i commenti a un post Facebook dal suo url. Ogni commento include autore, ID autore, like, numero di risposte, ora di pubblicazione e permalink. Le righe di risposta riutilizzano l'ID del gruppo padre, quindi ricostruisci le discussioni con depth e reply_to_id. Un albero completo non è garantito.

Riferimento API completo: parametri, esempi di codice, esempio di risposta e stato
urlObbligatorio
Specifica l'URL di destinazione corrispondente all'azione richiesta. Usa URL di Pagine pubbliche per profile e user_posts, URL di post per post e comments, URL di pagine di gruppi o identificatori di gruppo per group_posts e URL di pagine aziendali per reviews (che aggiunge /reviews). Gli URL Facebook non sono intercambiabili tra azioni diverse.
Documentazione ufficiale di Facebook: visibilità pubblica dei profili delle Pagine, dei post e dei commenti — La documentazione ufficiale di Meta tratta i dettagli pubblici di Pagine, profili, post e commenti; questa definizione di visibilità non garantisce che ogni URL sia leggibile, che ogni campo venga restituito né che questo endpoint disponga di un'autorizzazione di accesso di Meta. · Verificato
Documentazione ufficiale di Meta: la raccolta automatizzata dei dati richiede un'autorizzazione preventiva — Meta afferma esplicitamente che la raccolta automatizzata dei dati di Facebook senza autorizzazione preventiva viola i suoi termini, anche per i dati visibili pubblicamente. Citare fonti autorevoli non costituisce prova di autorizzazione alla raccolta o al riutilizzo dei dati della piattaforma. · Verificato

Cosa significano i parametri followers di API di Facebook?

Controlla il numero di follower, account seguiti, post e like di un account o di una Pagina Facebook tramite username. Un flag di precisione segnala i valori approssimativi. Restituisce solo i totali, non un elenco dei singoli follower.

Riferimento API completo: parametri, esempi di codice, esempio di risposta e stato
usernameObbligatorio
Specifica l'identificatore dell'account o della Pagina Facebook, senza simbolo @, per l'azione followers. Questa funzionalità restituisce un oggetto con il numero totale di follower, non un elenco esportato di singoli profili di follower né un grafo delle relazioni tra utenti.
Facebook: seguire una Pagina è diverso dal metterle Mi piace — La documentazione ufficiale di Facebook spiega che Follow serve a ricevere gli aggiornamenti di una Pagina e indica le differenze per le Pagine che passano dalla struttura Like a quella Follow; questo distingue `follower_count` da `like_count`, ma non indica che questa piattaforma possa esportare elenchi di follower. · Verificato
channelFacoltativo
Questo parametro serve per la compatibilità con l'identificatore dell'account nell'azione followers. Se viene fornito username, questo ha la precedenza, e le richieste pubbliche devono comunque includere il parametro obbligatorio username. Questo parametro non rappresenta l'ID di un canale di chat.

Cosa significano i parametri ads di API di Facebook?

Trova inserzioni nella Libreria inserzioni di Facebook tramite keyword o URL della Libreria inserzioni. Ottieni testo dell'inserzione, invito all'azione, landing page, date di pubblicazione, posizionamenti e inserzionista. Restringi per paese e status. Spesa, impression, targeting e conversioni non sono inclusi.

Riferimento API completo: parametri, esempi di codice, esempio di risposta e stato
keywordObbligatorio
Specifica la query di ricerca per endpoint distinti della piattaforma. Per search, cerca nei post pubblici; per ads, accetta parole chiave degli annunci o URL diretti di Ad Library e delle Pagine; per marketplace, accetta termini di ricerca di articoli o URL di ricerca completi di Marketplace. Ogni azione interroga un dataset diverso e non restituisce gli stessi risultati con nomi di campo diversi.
Documentazione ufficiale di Meta: inserzioni e ricerca per Pagina nella Ad Library — Alcuni comunicati storici di Meta presentano la ricerca delle inserzioni per parola chiave o per Pagina e mettono in evidenza le differenze nei dati di trasparenza tra le normali inserzioni attive e quelle su temi politici o sociali, oltre ai requisiti dell'API ufficiale; ciò non implica che tutte le inserzioni includano spesa, impression o cronologia completa, dato che questo endpoint non offre questi campi in modo stabile. · Verificato
countryFacoltativo
Specifica il codice paese per le query per parola chiave nell'azione ads, ad esempio US (predefinito US). I valori vengono convertiti in maiuscolo nella costruzione degli URL di richiesta. Se keyword è un URL completo, i parametri incorporati in quell'URL hanno la precedenza e questa impostazione del paese non viene applicata.
statusFacoltativo
Filtra lo stato delle inserzioni pubblicitarie con i valori consentiti: all (predefinito), active (attualmente in corso) o inactive (interrotte). Rappresenta lo stato di erogazione dell'inserzione, non lo stato di revisione. Se keyword è un URL di Ad Library, il valore active_status incorporato potrebbe differire da questo parametro; mantieni i due coerenti.

Cosa significano i parametri group_posts di API di Facebook?

Leggi i post di un gruppo Facebook tramite url o identificatore del gruppo. Ottieni testo, autore, ora di pubblicazione e numero di like, commenti e condivisioni. sort sceglie i post principali o l'attività recente. L'attività recente segue l'attività, non la data di creazione. La copertura completa non è garantita.

Riferimento API completo: parametri, esempi di codice, esempio di risposta e stato
urlObbligatorio
Specifica l'URL di destinazione corrispondente all'azione richiesta. Usa URL di Pagine pubbliche per profile e user_posts, URL di post per post e comments, URL di pagine di gruppi o identificatori di gruppo per group_posts e URL di pagine aziendali per reviews (che aggiunge /reviews). Gli URL Facebook non sono intercambiabili tra azioni diverse.
Documentazione ufficiale di Meta: i contenuti privati precedenti restano protetti quando un gruppo diventa pubblico — La documentazione ufficiale di Meta precisa che, quando un gruppo privato diventa pubblico, i nuovi contenuti diventano visibili pubblicamente, mentre i contenuti e gli elenchi dei membri della fase privata restano soggetti a restrizioni; quindi un gruppo attualmente pubblico non garantisce l'accesso ai post precedenti o all'elenco completo dei membri. · Verificato
Documentazione ufficiale di Meta: la raccolta automatizzata dei dati richiede un'autorizzazione preventiva — Meta afferma esplicitamente che la raccolta automatizzata dei dati di Facebook senza autorizzazione preventiva viola i suoi termini, anche per i dati visibili pubblicamente. Citare fonti autorevoli non costituisce prova di autorizzazione alla raccolta o al riutilizzo dei dati della piattaforma. · Verificato
sortFacoltativo
Specifica l'ordine dei post per group_posts: top per i post principali o recent per i post con attività recente; se omesso, usa l'ordine cronologico. L'opzione recent si basa sull'attività, non solo sulla data di creazione del post. I valori stringa non supportati ricadono sull'ordine cronologico invece di restituire un errore.

Cosa significano i parametri marketplace di API di Facebook?

Sfoglia gli annunci di Facebook Marketplace per la keyword di un oggetto in una città. Ottieni prezzo, valuta, città, stato, condizioni, immagine e ora di pubblicazione. location accetta un percorso di città come nyc, il valore predefinito, non un indirizzo. La disponibilità non è confermata.

Riferimento API completo: parametri, esempi di codice, esempio di risposta e stato
keywordObbligatorio
Specifica la query di ricerca per endpoint distinti della piattaforma. Per search, cerca nei post pubblici; per ads, accetta parole chiave degli annunci o URL diretti di Ad Library e delle Pagine; per marketplace, accetta termini di ricerca di articoli o URL di ricerca completi di Marketplace. Ogni azione interroga un dataset diverso e non restituisce gli stessi risultati con nomi di campo diversi.
locationFacoltativo
Specifica l'identificatore di percorso della città per marketplace, ad esempio nyc (predefinito nyc). Non accetta indirizzi in formato libero. Se keyword contiene un URL completo di Marketplace, quell'URL ha la precedenza e location viene ignorato.
Documentazione ufficiale di Meta: schede prodotto di Marketplace e limiti della ricerca per località — La documentazione storica di Meta definisce Marketplace come una funzione per pubblicare e scoprire articoli in vendita a livello locale, distinguendo titolo, prezzo e località dell'articolo. Descrive soltanto questi oggetti; non stabilisce che le opzioni di filtro dell'interfaccia nativa o la disponibilità regionale storica siano funzionalità attuali di questo endpoint. · Verificato

Cosa significano i parametri reviews di API di Facebook?

Raccogli consigli e recensioni da una Pagina Facebook tramite url, con testo, consiglia o non consiglia, valutazione se presente, autore e ora di pubblicazione. Facebook usa consiglia o non consiglia al posto delle stelle, quindi una valutazione mancante non annulla un consiglio.

Riferimento API completo: parametri, esempi di codice, esempio di risposta e stato
urlObbligatorio
Specifica l'URL di destinazione corrispondente all'azione richiesta. Usa URL di Pagine pubbliche per profile e user_posts, URL di post per post e comments, URL di pagine di gruppi o identificatori di gruppo per group_posts e URL di pagine aziendali per reviews (che aggiunge /reviews). Gli URL Facebook non sono intercambiabili tra azioni diverse.
Documentazione ufficiale di Facebook: consigli e recensioni delle Pagine — La documentazione ufficiale spiega che i consigli vengono mostrati nella sezione Reviews di una Pagina e precisa che la rimozione delle recensioni che violano le regole può modificare la valutazione della Pagina. La valutazione complessiva di una Pagina è distinta dal singolo consiglio, quindi `is_recommended` non può essere convertito automaticamente in un punteggio a stelle. · Verificato
Documentazione ufficiale di Meta: la raccolta automatizzata dei dati richiede un'autorizzazione preventiva — Meta afferma esplicitamente che la raccolta automatizzata dei dati di Facebook senza autorizzazione preventiva viola i suoi termini, anche per i dati visibili pubblicamente. Citare fonti autorevoli non costituisce prova di autorizzazione alla raccolta o al riutilizzo dei dati della piattaforma. · Verificato

Cosa significano i parametri advertiser_search di API di Facebook?

Trova le Pagine Facebook che fanno pubblicità con un brand o un nome di inserzionista nella Libreria inserzioni, fino a 15 per chiamata. Ogni Pagina include ID, nome, username, categoria, flag di verifica, like della Pagina e l'account Instagram collegato con il suo numero di follower. Una ricerca per nike mostra per prima Nike (ID Pagina 15087023444). Non c'è paginazione.

Riferimento API completo: parametri, esempi di codice, esempio di risposta e stato
keywordObbligatorio
Il nome di un brand o di un inserzionista, ad esempio nike. Restituisce le Pagine che pubblicano inserzioni con quel nome nella Libreria inserzioni; ogni id è l'ID di una Pagina.

Cosa significano i parametri ad_detail di API di Facebook?

Apri un'inserzione nella Libreria inserzioni di Facebook dal suo link o dall'ID della Libreria. Ottieni se è ancora attiva, date di inizio e fine, testo, titolo, link e invito all'azione, formato di visualizzazione, posizionamenti in cui è stata pubblicata, immagini o video, tutte le varianti creative, e ID, nome, like e categorie della Pagina dell'inserzionista. Spesa, copertura e targeting non sono inclusi nel risultato.

Riferimento API completo: parametri, esempi di codice, esempio di risposta e stato
urlObbligatorio
Una singola inserzione: un link della Libreria inserzioni (https://www.facebook.com/ads/library/?id=<Library ID>) o direttamente l'ID numerico della libreria (l'id di una riga di ads).

Cosa significano i parametri events_search di API di Facebook?

Cerca eventi Facebook pubblici tramite keyword, ad esempio music festival. Ogni evento include nome, ora di inizio, data come la mostra Facebook, luogo, flag online, se si è già svolto, numero di partecipanti e interessati, testo del prezzo dei biglietti quando presente e immagine di copertina. Sono inclusi gli eventi passati. Circa 5 per pagina; vai avanti con next_page_token.

Riferimento API completo: parametri, esempi di codice, esempio di risposta e stato
keywordObbligatorio
Le parole con cui cercare eventi pubblici, ad esempio music festival o yoga Singapore. Sono inclusi anche gli eventi passati; controlla is_past.
page_tokenFacoltativo
Token di pagina per events_search e page_events. Omettilo per la prima pagina, poi passa il next_page_token della risposta precedente esattamente come l'hai ricevuto; l'ultima pagina non ne ha.

Cosa significano i parametri marketplace_item di API di Facebook?

Leggi un annuncio di Facebook Marketplace dal suo link o ID numerico. Ottieni titolo, descrizione, prezzo e prezzo originale, valuta, condizioni, attributi dell'oggetto, posizione con coordinate, data dell'annuncio, flag venduto e in sospeso, opzioni di spedizione e consegna, foto, oltre a nome, valutazione, numero di valutazioni e data di iscrizione del venditore.

Riferimento API completo: parametri, esempi di codice, esempio di risposta e stato
urlObbligatorio
Una singola scheda prodotto: il link di un elemento di Marketplace (https://www.facebook.com/marketplace/item/<ID>/) o l'ID numerico dell'elemento (l'id di una riga di marketplace).

Cosa significano i parametri page_events di API di Facebook?

Elenca gli eventi, futuri e passati, ospitati da una Pagina Facebook pubblica, partendo dal link della Pagina. Ogni evento include nome, ora di inizio, luogo, città, organizzatore e flag online, passato e annullato. Fino a 10 per pagina e il numero varia; vai avanti con next_page_token. Una Pagina che non ospita eventi restituisce un elenco vuoto.

Riferimento API completo: parametri, esempi di codice, esempio di risposta e stato
urlObbligatorio
Il link di una Pagina pubblica, ad esempio https://www.facebook.com/brickyardoldtown; funzionano anche i link /p/<name>-<ID>.
page_tokenFacoltativo
Token di pagina per events_search e page_events. Omettilo per la prima pagina, poi passa il next_page_token della risposta precedente esattamente come l'hai ricevuto; l'ultima pagina non ne ha.

Cosa significano i parametri post_transcript di API di Facebook?

Trascrivi il parlato di un video, Reel o post video pubblico di Facebook, dal suo link. Ottieni la trascrizione e la durata del video in secondi. Un video in cui nessuno parla viene restituito senza text.

Riferimento API completo: parametri, esempi di codice, esempio di risposta e stato
urlObbligatorio
Il link di un video pubblico, di un Reel o di un post con video, ad esempio https://www.facebook.com/reel/<ID>/.

Come usare l'API di Facebook

  1. 01Scegli un'azione della piattaforma dal catalogo pubblico.
  2. 02Invia piattaforma, azione e parametri obbligatori a POST /api/v1/social.
  3. 03Leggi il risultato dalla risposta. Per un'azione asincrona, interroga periodicamente il job ID restituito.
  4. 04Salva i campi della risposta che servono alla tua applicazione.
facebook_search.sh
curl -X POST https://api.everyinfra.com/api/v1/social \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"platform":"facebook","action":"search","params":{"keyword":"<keyword>"}}'

Guide su API di Facebook

Esempi pratici e metodi basati su queste azioni. Verifica prima azioni, parametri e campi attuali in questa pagina: esempi e limiti di un articolo non sostituiscono il catalogo aggiornato.

Build

Schema per il monitoraggio della reputazione su più piattaforme: definisci l'ambito prima di valutare i peggioramenti

Progetta un flusso di monitoraggio della reputazione tracciabile partendo da elenchi di target, identità dei commenti e cursori incrementali; usa campioni offline per mostrare la deduplicazione e le lacune di acquisizione, mantenendo la revisione manuale.

Leggi l'articolo
Build

Primi passi con l'API unificata per i dati: dal catalogo delle funzionalità al primo risultato utilizzabile

Accedi ai dati di più piattaforme con platform, action e params: leggi il catalogo delle funzionalità, completa richieste minime, gestisci task asincroni, risultati parziali e addebiti, e crea record di dati tracciabili.

Leggi l'articolo

Domande sull'API di Facebook

Cosa posso ottenere con l'API di Facebook?

Imposta platform su facebook. Il catalogo attuale elenca ricerca, dettagli, post dell'utente, dettagli del post, commenti e more. Questi nomi di azione identificano oggetti o viste diversi di Facebook; non sono modalità di ricerca intercambiabili.

Facebook ha un'API ufficiale?

Sì. La Graph API di Meta è l'interfaccia ufficiale. Per leggere post e commenti pubblici di Pagine Facebook che la tua app non gestisce serve la funzionalità Page Public Content Access, che Meta concede solo dopo l'App Review e la verifica dell'azienda; la timeline di una persona è disponibile solo con il suo permesso e per usi limitati.

Fonti ufficiali: «Meta: Page Public Content Access» · Meta Graph API · Verificato

Mi serve un account sviluppatore o una chiave API di Facebook?

No. Le richieste passano da EveryInfra con una chiave API EveryInfra: registrati, crea una chiave nella console e inviala come Authorization: Bearer <API_KEY>. Non devi registrare un'app nel portale per sviluppatori di Facebook, richiedere l'accesso alle API di Facebook né accedere con un account Facebook; le azioni restituiscono solo dati pubblici di Facebook.

Quanto costa l'API di Facebook per 1.000 richieste?

Da $0.88 per 1.000 richieste, a seconda dell'azione; il prezzo di ogni azione è indicato nella tabella di questa pagina e nel catalogo pubblico. Non c'è alcun abbonamento: ricarichi un saldo in USD e paghi per chiamata, e le chiamate non riuscite e i risultati vuoti non vengono addebitati.

Quale input avvia la richiesta search di Facebook?

Specifica la query di ricerca per endpoint distinti della piattaforma. Per search, cerca nei post pubblici; per ads, accetta parole chiave degli annunci o URL diretti di Ad Library e delle Pagine; per marketplace, accetta termini di ricerca di articoli o URL di ricerca completi di Marketplace. Ogni azione interroga un dataset diverso e non restituisce gli stessi risultati con nomi di campo diversi. Invialo come keyword all'interno di params.

Quali campi può restituire search di Facebook?

Il suo schema dichiarato include text, author_name, author_username e author_id. Un campo dichiarato può comunque mancare in un singolo record, e ogni altra azione ha il proprio elenco di campi.

Tutte le azioni di Facebook 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 e consegna async.

Le nostre statistiche di visita interne sono sempre attive. Google Analytics viene caricato solo se scegli «Consenti analisi». Informativa sulla privacy