Torna alle API
Dati di brand monitoring

Brand Monitoring API

Trova le pagine web che citano un brand, un prodotto o un tema, assegna a ciascuna un punteggio di sentiment ed emozione e riassumi come ne parla il web.

API di Brand Monitoring disponibili

Usa Brand Mentions API per le prove pagina per pagina con punteggi di sentiment e autorevolezza, oppure Brand Sentiment Analysis API per una riga di sintesi per sentiment ed emozione.

Quali dati di brand monitoring puoi recuperare?

Le due API lavorano sullo stesso insieme di pagine web indicizzate: una restituisce le pagine, l’altra le riassume.

Menzioni su pagine web

Titolo, URL, passaggio attorno alla menzione, autore, dominio, lingua, paese e data di pubblicazione o di raccolta.

Sentiment ed emozioni

Quote positiva, negativa e neutra con somma 1, e punteggi da 0 a 1 per gioia, amore, divertimento, condivisione, tristezza e rabbia.

Autorevolezza e qualità

Rank di dominio e di pagina da 0 a 1000, e punteggi di spam e di qualità del contenuto da 0 a 100.

Tipi di sito

Se ogni pagina è un articolo di giornale, un blog, un forum, una pagina e-commerce o il sito di un’organizzazione.

Ripartizione del sentiment

Numero di pagine per gruppo di sentiment e di emozione, con i domini, i paesi, le lingue e i tipi di pagina principali di ogni gruppo.

Brand Mentions o Brand Sentiment Analysis

Esegui entrambe con la stessa query quando ti servono il quadro d’insieme e le pagine che lo compongono.

ConfrontoBrand Mentions APIBrand Sentiment Analysis API
RisultatoUna riga per pagina webUna riga di sintesi per query
SentimentPunteggi del passaggio di ogni paginaNumero di pagine per gruppo di sentiment ed emozione
FontiDominio, autore, tipo di sito e autorevolezza per paginaDomini, paesi, lingue e tipi di pagina principali per gruppo
Filtriquery, content_type e results_limit fino a 1.000query
Prezzo10 crediti per richiesta più 0,02 per pagina10 crediti per richiesta

Come funziona l’API di Brand Monitoring

Le due API seguono lo stesso flusso di attività asincrone.

  1. 1. Invia una query

    Invia un brand, un prodotto o un tema in POST a /v1/brand-monitoring/mentions o /v1/brand-monitoring/sentiment.

  2. 2. Segui l’attività

    Interroga GET /v1/tasks/{task_id} finché status non diventa succeeded; i termini ampi possono richiedere alcuni minuti.

  3. 3. Leggi i risultati

    Leggi le pagine o la riga di sintesi in results.items.

Trova le menzioni di un brand sul web

Autenticati con la tua chiave API SocQ e invia il nome di un brand. Ogni richiesta costa 10 crediti più 0,02 crediti per pagina restituita.

curl -X POST "https://api.socq.ai/v1/brand-monitoring/mentions" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"notion","results_limit":100}'

# Poll GET /v1/tasks/{task_id}
# Read the mentions in results.items

Casi d’uso comuni dell’API di Brand Monitoring

Monitoraggio della reputazione

Segnala i passaggi negativi sulle pagine più autorevoli ed esaminali per primi.

Monitoraggio della stampa

Raccogli dopo un lancio o un annuncio le menzioni sui giornali con autore, data e rank del dominio.

Benchmark con la concorrenza

Confronta sentiment, emozioni e mix di fonti tra il tuo brand e i concorrenti.

Ascolto delle community

Raccogli le discussioni nei forum in cui le persone descrivono un prodotto con parole proprie.

Bilancio delle campagne

Confronta i gruppi di sentiment ed emozione prima e dopo una campagna.

Regole di richiesta e prezzi

Queste regole valgono per entrambe le API di Brand Monitoring.

  • query accetta un brand, un prodotto o un tema fino a 100 caratteri; le frasi tra virgolette doppie vengono cercate in modo esatto.
  • Brand Mentions API accetta come content_type news, blogs, message-boards, ecommerce o organization, e restituisce da 1 a 1.000 pagine, 100 di default.
  • La maggior parte delle sintesi di sentiment si completa in meno di un minuto; i termini ampi con milioni di pagine corrispondenti possono richiedere alcuni minuti.
  • Brand Mentions API costa 10 crediti per richiesta più 0,02 crediti per pagina restituita; Brand Sentiment Analysis API costa 10 crediti per richiesta.

Domande frequenti sull’API di Brand Monitoring

Che cos’è Brand Monitoring API?

Brand Monitoring API trova le pagine web che citano un brand, un prodotto o un tema e ne misura il sentiment, pagina per pagina con Brand Mentions API o come sintesi con Brand Sentiment Analysis API.

Quali API di Brand Monitoring sono disponibili?

Brand Mentions API per le singole pagine con punteggi di sentiment, emozione e autorevolezza, e Brand Sentiment Analysis API per la ripartizione di sentiment ed emozioni di tutte le pagine corrispondenti.

Quali siti web sono coperti?

Pagine web pubbliche indicizzate, come articoli di giornale, blog, forum, pagine e-commerce e siti di organizzazioni.

Come viene misurato il sentiment?

Il passaggio attorno a ogni menzione viene valutato come positivo, negativo o neutro e per sei emozioni; la sintesi raggruppa poi le pagine in base a questi punteggi.

Come vengono addebitate le richieste di Brand Monitoring?

Brand Mentions API costa 10 crediti per richiesta più 0,02 crediti per pagina restituita. Brand Sentiment Analysis API costa 10 crediti per richiesta.

Riunisci in un unico flusso i dati pubblici di profili, contenuti ed engagement di piattaforme diverse per monitorare brand, creator e argomenti e condurre monitoraggi e analisi cross-platform in modo più efficiente.