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.
| Confronto | Brand Mentions API | Brand Sentiment Analysis API |
|---|---|---|
| Risultato | Una riga per pagina web | Una riga di sintesi per query |
| Sentiment | Punteggi del passaggio di ogni pagina | Numero di pagine per gruppo di sentiment ed emozione |
| Fonti | Dominio, autore, tipo di sito e autorevolezza per pagina | Domini, paesi, lingue e tipi di pagina principali per gruppo |
| Filtri | query, content_type e results_limit fino a 1.000 | query |
| Prezzo | 10 crediti per richiesta più 0,02 per pagina | 10 crediti per richiesta |
Come funziona l’API di Brand Monitoring
Le due API seguono lo stesso flusso di attività asincrone.
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. Segui l’attività
Interroga GET /v1/tasks/{task_id} finché status non diventa succeeded; i termini ampi possono richiedere alcuni minuti.
3. Leggi i risultati
Leggi le pagine o la riga di sintesi in results.items.
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.itemsCasi 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.
Combina i dati di più piattaforme per analisi di business più complete
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.
AI Search API
Segui come AI Overview, ChatGPT e Google AI Mode rispondono alle domande del tuo mercato: le risposte che citano il tuo brand, quanto sei visibile e quali domini e pagine vengono citati.
Instagram API
Cerca o trova profili pubblici e raccogli con un unico flusso asincrono record degli elenchi di follower, relazioni di seguiti, post pubblicati, post in cui un profilo è taggato, risultati per hashtag, Reels, trascrizioni, commenti, numeri degli account, metriche di engagement e metadati dei media.
TikTok API
Raccogli profili TikTok pubblici supportati, metadati di video diretti, commenti di primo livello, risultati di ricerca dei video e video di hashtag specifici con un unico flusso di lavoro asincrono normalizzato.
YouTube API
Raccogli profili dei canali YouTube pubblici supportati, dettagli dei video, video dei canali, commenti, Shorts, risultati per parola chiave e hashtag e trascrizioni disponibili con un unico flusso di lavoro asincrono normalizzato.
Facebook API
Raccogli profili di pagine Facebook pubbliche, post, post di gruppi, commenti, eventi trovati per parola chiave e trascrizioni disponibili dei video, con campi normalizzati di identità, contenuti, origine, formato, luogo, media, reazioni, partecipazione ed engagement.
X API
Raccogli profili pubblici, relazioni di follower e seguiti, post, risposte, citazioni, repost, risultati di ricerca e tendenze attuali. Usa risultati coerenti per ricerca e monitoraggio.

