Brand Mentions
Una menzione del brand è una pagina web pubblica nel cui testo compare il marchio, che si tratti di una recensione, di un articolo di giornale, di una discussione in un forum o di una pagina prodotto, insieme al passaggio attorno al nome, all’autore, alla lingua, al paese e alla data di pubblicazione. Valutate per sentiment e ordinate per autorevolezza di pagina e dominio, queste pagine mostrano dove si parla di un brand, verso quale tono va la conversazione e quali fonti pesano di più, la base per monitorare la brand reputation, misurare i risultati delle PR e analizzare la concorrenza.
Funzionalità della Brand Mentions API
- Ricerca per parola chiave e corrispondenza esattaquery accetta un brand, un prodotto o un tema fino a 100 caratteri; le frasi tra virgolette doppie vengono cercate alla lettera.
- Filtro per tipo di sitocontent_type limita i risultati a news, blogs, message-boards, ecommerce o organization, e page_types indica il tipo di ogni risultato.
- Sentiment per passaggiosentiment suddivide il passaggio tra positivo, negativo e neutro con somma 1, ed emotions assegna da 0 a 1 un punteggio a gioia, amore, divertimento, condivisione, tristezza e rabbia.
- Autorevolezza e qualitàdomain_rank e page_rank misurano l’autorevolezza da 0 a 1000, mentre spam_score e content_quality_score aiutano a scartare pagine povere o di spam.
- Il contesto di ogni menzionetitle, il passaggio in text, author_name, language, country, published_at quando presente e fetched_at indicano quando e dove è stata scritta la menzione.
- Fino a 1.000 pagine per richiestaresults_limit va da 1 a 1000, per fare il punto sulla presenza di un brand sul web in un solo passaggio.
Parametri della Brand Mentions API
| Parametri | Obbligatorio | Descrizione |
|---|---|---|
query | Obbligatorio | Brand, prodotto o tema da cercare (fino a 100 caratteri). Le frasi tra virgolette doppie vengono cercate in modo esatto. |
content_type | Facoltativo | Tipo di sito da cui provengono le menzioni: news, blogs, message-boards, ecommerce o organization. |
results_limit | Facoltativo | Numero di pagine restituite (1–1000). Il valore predefinito è 100. |
Come usare la Brand Mentions API
Invia il nome di un brand o di un prodotto e leggi le menzioni riga per riga.
- Invia {"query": "notion", "results_limit": 100} in POST a /v1/brand-monitoring/mentions.
- Interroga GET /v1/tasks/{task_id} finché status non diventa succeeded.
- Leggi le pagine in results.items e usa results.next_cursor per la pagina successiva finché has_more è true.
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}'Casi d’uso della Brand Mentions API
- Monitoraggio della reputazione: Segnala i passaggi in cui sentiment.negative supera il punteggio positivo e dai loro priorità in base al domain_rank della pagina.
- Monitoraggio della copertura stampa: Imposta content_type su news e registra author_name, published_at e domain_rank per sapere quali testate hanno parlato di un lancio e con quale portata.
- Confronto tra brand: Esegui la stessa richiesta per il tuo brand e per un concorrente e confronta tipi di sito, paesi e distribuzione del sentiment delle menzioni.
- La voce delle community: Limita content_type a message-boards per raccogliere le discussioni in cui gli utenti descrivono un prodotto con parole proprie.
Consigli degli esperti per la Brand Mentions API
- Racchiudi tra virgolette doppie i nomi di brand composti da più parole, come "notion ai", per cercare la frase esatta.
- Per valutare l’attualità usa published_at e, se manca, fetched_at: molte pagine non indicano una data di pubblicazione.
- Escludi le righe con spam_score alto o content_quality_score basso prima di aggregare il sentiment, così le pagine povere non falsano il risultato.
- Abbinala a Brand Sentiment Analysis API quando ti servono sia il dettaglio per pagina sia le proporzioni complessive.
API correlate
Oltre alla Brand Mentions API, usa queste API quando ti serve un altro tipo di dati pubblici di Brand Monitoring.
- Brand Sentiment Analysis API — Riassumi in una riga come il web parla di un brand o di un tema, con il numero di pagine per sentiment ed emozione e i domini, i paesi e le lingue principali di ogni gruppo.