brand-monitoring/
mentions

Trova le pagine web che citano un brand, un prodotto o un tema e ottieni per ciascuna il passaggio, l’autore, la data, il tipo di sito, i punteggi di sentiment e l’autorevolezza.

Brand Mentions API

Menzioni su tutto il web
Sentiment per passaggio
Filtro per tipo di sito
Autorevolezza e punteggio spam
10 crediti per richiesta + 0,02 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

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

ParametriObbligatorioDescrizione
queryObbligatorioBrand, prodotto o tema da cercare (fino a 100 caratteri). Le frasi tra virgolette doppie vengono cercate in modo esatto.
content_typeFacoltativoTipo di sito da cui provengono le menzioni: news, blogs, message-boards, ecommerce o organization.
results_limitFacoltativoNumero 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.

  1. Invia {"query": "notion", "results_limit": 100} in POST a /v1/brand-monitoring/mentions.
  2. Interroga GET /v1/tasks/{task_id} finché status non diventa succeeded.
  3. 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.

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.

Esplora altre piattaforme

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

Brand Mentions API — FAQ

Brand Mentions API trova le pagine web che citano un brand, un prodotto o un tema e restituisce per ciascuna il passaggio, l’autore, la data, il tipo di sito, i punteggi di sentiment ed emozioni e i punteggi di autorevolezza e spam.

Le pagine web indicizzate il cui testo corrisponde alla tua ricerca, tra cui articoli di giornale, recensioni sui blog, forum, pagine prodotto di e-commerce e siti aziendali. Con content_type puoi sceglierne un solo tipo.

Sul passaggio che circonda la menzione: sentiment fornisce le quote positiva, negativa e neutra con somma 1, ed emotions un punteggio da 0 a 1 per ciascuna delle sei emozioni.

Sì. Racchiudi il nome tra virgolette doppie in query per ottenere una corrispondenza esatta.

10 crediti per richiesta più 0,02 crediti per ogni pagina restituita. I 10 crediti vengono addebitati anche quando non si trova alcuna pagina.