facebook/
company-reviews

Raccogli le recensioni pubbliche delle pagine Facebook dagli URL /reviews, con testo delle recensioni, link di chi ha recensito, valutazioni, Mi piace, timestamp e contesto dell’azienda come record normalizzati.

Facebook Company Reviews API

Recensioni delle pagine
Contesto di chi recensisce
Valutazioni dell’azienda
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

Facebook Company Reviews

Le recensioni aziendali di Facebook sono raccomandazioni o valutazioni pubbliche di una pagina, con feedback scritto, identità di chi recensisce, orario di pubblicazione, Mi piace visibili e segnali di recensione a livello di azienda. Questi record supportano la ricerca sul feedback, le istantanee della reputazione, l’analisi del contesto di chi recensisce e i confronti tra pagine note.

Funzionalità della Facebook Company Reviews API

  • Raccolta da URL delle recensioni di una paginaAccetta uno o più URL /reviews supportati di pagine Facebook e raccoglie le righe di recensioni pubbliche disponibili per ogni input.
  • Record di recensioni e di chi le scriveRestituisce ID delle recensioni, URL di origine, testo, nomi e link ai profili di chi recensisce, Mi piace visibili, valori di valutazione e orari di pubblicazione in una struttura normalizzata.
  • Contesto a livello di aziendaConserva nomi delle aziende, URL delle pagine, valutazioni aggregate e numero totale di recensioni accanto alle singole recensioni, per il confronto a livello di fonte.

Parametri della Facebook Company Reviews API

ParametriObbligatorioDescrizione
urlsObbligatorioURL delle recensioni di pagine Facebook su facebook.com, www.facebook.com o m.facebook.com il cui percorso contiene /reviews, separati da virgole o a capo.
results_limitFacoltativoNumero massimo di recensioni richieste per ogni URL di input, da 20 a 2.000; il valore predefinito è 100 e i risultati pubblici disponibili possono essere meno.

Come usare la Facebook Company Reviews API

Invia gli URL /reviews delle pagine Facebook come attività asincrona, interroga il relativo ID attività, poi leggi i record normalizzati delle recensioni con la paginazione a cursore.

  1. Prepara uno o più URL di pagine Facebook pubbliche il cui percorso contiene /reviews.
  2. Invia con POST urls e un results_limit facoltativo a /v1/facebook/company-reviews.
  3. Interroga /v1/tasks/{task_id} finché lo stato è succeeded.
  4. Leggi /v1/tasks/{task_id}?limit=50 e passa results.next_cursor come cursor finché results.has_more è true.
curl -X POST "https://api.socq.ai/v1/facebook/company-reviews" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://www.facebook.com/PepsiCo/reviews/"],"results_limit":100}'

# Poll GET /v1/tasks/{task_id}, then request
# GET /v1/tasks/{task_id}?limit=50&cursor={results.next_cursor}.

Casi d’uso della Facebook Company Reviews API

  • Preparazione di dataset di feedback: Usa testo delle recensioni, valori di valutazione, orari di pubblicazione e URL di origine per preparare dataset di feedback pubblico da analizzare poi per argomenti o sentiment.
  • Report con istantanee della reputazione: Combina le valutazioni delle singole recensioni con le valutazioni a livello di azienda e il numero totale di recensioni per documentare lo stato visibile di pagine selezionate.
  • Ricerca sull’engagement di chi recensisce: Usa nomi di chi recensisce, link ai profili e conteggi dei Mi piace visibili per esaminare chi ha lasciato feedback pubblico e quali recensioni hanno ottenuto engagement.

Consigli degli esperti per la Facebook Company Reviews API

  • Usa un URL /reviews risolvibile di una pagina Facebook e non il nome di un’azienda o l’URL generico di una pagina.
  • Imposta results_limit per ogni URL di input in base alla profondità che ti serve e aspettati meno righe quando Facebook espone meno cronologia pubblica delle recensioni.
  • Invia ogni URL di pagina una sola volta, perché gli URL di input duplicati vengono rimossi prima della raccolta.
  • Considera nullable i link di chi recensisce, le valutazioni, i Mi piace, i timestamp e gli aggregati dell’azienda quando Facebook non espone un valore.
  • Segui results.next_cursor finché results.has_more è false, così le attività completate di grandi dimensioni vengono lette senza saltare record salvati.

Oltre alla Facebook Company Reviews API, usa queste API quando ti serve un altro tipo di dati pubblici di Facebook.

  • Facebook Pages API — Recupera i profili pubblici delle Pagine, i dati di contatto, le immagini e le valutazioni visibili del pubblico.
  • Facebook Posts API — Raccoglie post pubblici, media, reazioni, commenti e condivisioni da URL Facebook supportati.
  • Facebook Comments API — Raccoglie commenti pubblici, autori, engagement, media e link alla fonte a partire dagli URL dei post.
  • Facebook Video Transcript API — Estrae, quando disponibili, il testo e il formato della trascrizione dagli URL pubblici di video o Reels noti.
  • Facebook Comment Replies API — Recupera le risposte pubbliche a un commento noto tramite il suo ID del feedback e il token di espansione, con testo, identità dell’autore, engagement e contesto del commento principale.
  • Facebook Profiles API — Consulta profili o Pagine pubblici da URL Facebook noti con identità, bio, avatar, contatori visibili e contesto dell’input.

Esplora altre piattaforme

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

Facebook Company Reviews API — FAQ

Facebook Company Reviews API è un’interfaccia programmatica per raccogliere recensioni e raccomandazioni da un URL /reviews di una pagina Facebook pubblica in un insieme coerente di feedback. Offre ai team che si occupano di reputazione una base per istantanee, analisi dei temi e confronti tra pagine note, restando limitata ai contenuti visibili nelle pagine pubbliche delle recensioni.

Invia uno o più URL di pagine Facebook su facebook.com, www.facebook.com o m.facebook.com con /reviews nel percorso. Il nome di un’azienda o l’URL di una pagina non correlata non sono sostituti validi.

Un record può contenere ID e URL della recensione, testo, nome e URL del profilo di chi recensisce, Mi piace visibili, un valore di valutazione, created_at, collected_at, nome e URL dell’azienda, valutazione dell’azienda e numero totale di recensioni.

results_limit ha come valore predefinito 100 e accetta numeri interi da 20 a 2.000 per ogni URL di input. È un tetto massimo, quindi la visibilità pubblica e la disponibilità della fonte possono produrre meno recensioni.

Interroga l’ID attività restituito finché il suo stato è succeeded, poi leggi i record di recensioni salvati dall’endpoint dei risultati dell’attività.

Ogni record di recensione effettivamente salvato costa 0,5 crediti, senza alcun addebito base per l’attività. Un risultato vuoto non comporta quindi alcun addebito per risultato.