brand-monitoring/
mentions

Encuentre las páginas web que mencionan una marca, un producto o un tema y obtenga de cada una el fragmento, el autor, la fecha, el tipo de sitio, las puntuaciones de sentimiento y la autoridad.

Brand Mentions API

Menciones en toda la web
Sentimiento por fragmento
Filtro por tipo de sitio
Autoridad y puntuación de spam
10 créditos por solicitud + 0.02 créditos por resultado
Listo
Listo

Ingrese los parámetros y envíe una solicitud. El estado de la tarea y los resultados normalizados aparecerán aquí.

README

Por SocQ · Actualizado el

Brand Mentions

Una mención de marca es una página web pública en cuyo texto aparece la marca, ya sea una reseña, un artículo de prensa, un hilo de foro o una página de producto, junto con el fragmento que rodea al nombre, el autor, el idioma, el país y la fecha de publicación. Con una puntuación de sentimiento y ordenadas por la autoridad de la página y del dominio, estas páginas muestran dónde se habla de una marca, hacia dónde se inclina la conversación y qué fuentes tienen más peso, la base para monitorear la reputación, medir el impacto de relaciones públicas e investigar a la competencia.

Funcionalidades de la Brand Mentions API

  • Búsqueda por palabra clave y coincidencia exactaquery acepta una marca, un producto o un tema de hasta 100 caracteres; las frases entre comillas dobles se buscan tal cual.
  • Filtro por tipo de sitiocontent_type limita los resultados a news, blogs, message-boards, ecommerce u organization, y page_types indica el tipo de cada resultado.
  • Sentimiento por fragmentosentiment reparte el fragmento entre positivo, negativo y neutral con suma 1, y emotions puntúa de 0 a 1 la alegría, el amor, la diversión, el compartir, la tristeza y el enojo.
  • Autoridad y calidaddomain_rank y page_rank miden la autoridad de 0 a 1000, y spam_score y content_quality_score ayudan a descartar páginas pobres o de spam.
  • El contexto de cada mencióntitle, el fragmento en text, author_name, language, country, published_at cuando existe y fetched_at indican cuándo y dónde se escribió la mención.
  • Hasta 1,000 páginas por consultaresults_limit va de 1 a 1000, para revisar en una sola pasada la presencia de una marca en la web.

Parámetros de la Brand Mentions API

ParámetrosObligatorioDescripción
queryObligatorioMarca, producto o tema que se busca (hasta 100 caracteres). Las frases entre comillas dobles se buscan de forma exacta.
content_typeOpcionalTipo de sitio del que provienen las menciones: news, blogs, message-boards, ecommerce u organization.
results_limitOpcionalNúmero de páginas que se devuelven (1–1000). El valor predeterminado es 100.

Cómo usar la Brand Mentions API

Envíe el nombre de una marca o de un producto y lea las menciones fila por fila.

  1. Envíe {"query": "notion", "results_limit": 100} por POST a /v1/brand-monitoring/mentions.
  2. Consulte GET /v1/tasks/{task_id} hasta que status sea succeeded.
  3. Lea las páginas en results.items y use results.next_cursor para obtener la siguiente página mientras has_more sea 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}'

Casos de uso de la Brand Mentions API

  • Monitoreo de reputación: Marque los fragmentos en los que sentiment.negative supera la puntuación positiva y priorícelos según el domain_rank de la página.
  • Seguimiento de cobertura en prensa: Configure content_type como news y registre author_name, published_at y domain_rank para saber qué medios cubrieron un lanzamiento y con qué alcance.
  • Comparación entre marcas: Ejecute la misma solicitud para su marca y para un competidor y compare los tipos de sitio, los países y la distribución del sentimiento de las menciones.
  • La voz de las comunidades: Limite content_type a message-boards para reunir hilos en los que los usuarios describen un producto con sus propias palabras.

Consejos de expertos para la Brand Mentions API

  • Escriba los nombres de marca de varias palabras entre comillas dobles, como "notion ai", para buscar la frase exacta.
  • Para juzgar la actualidad, use published_at y, si falta, fetched_at; muchas páginas no muestran fecha de publicación.
  • Quite las filas con spam_score alto o content_quality_score bajo antes de agregar el sentimiento, para que las páginas pobres no distorsionen el resultado.
  • Combínela con Brand Sentiment Analysis API cuando necesite tanto el detalle por página como las proporciones generales.

Además de la Brand Mentions API, use estas APIs cuando necesite otro tipo de datos públicos de Brand Monitoring.

  • Brand Sentiment Analysis API — Resuma en una fila cómo habla la web de una marca o un tema, con el número de páginas por sentimiento y emoción y los dominios, países e idiomas principales de cada grupo.

Explorar otras plataformas

Combine los datos de Brand Monitoring con datos públicos de otras plataformas sociales compatibles.

Brand Mentions API — FAQ

Brand Mentions API encuentra las páginas web que mencionan una marca, un producto o un tema y devuelve de cada una el fragmento, el autor, la fecha, el tipo de sitio, las puntuaciones de sentimiento y emoción, y las puntuaciones de autoridad y spam.

Las páginas web indexadas cuyo texto coincide con su búsqueda, como artículos de prensa, reseñas en blogs, foros, páginas de producto de tiendas en línea y sitios corporativos. Con content_type puede elegir uno de esos tipos.

Sobre el fragmento que rodea a la mención: sentiment da las proporciones positiva, negativa y neutral con suma 1, y emotions una puntuación de 0 a 1 para cada una de las seis emociones.

Sí. Escriba el nombre entre comillas dobles en query para obtener una coincidencia exacta.

10 créditos por solicitud más 0.02 créditos por página devuelta. Los 10 créditos se cobran también cuando no se encuentra ninguna página.