ES

Búsqueda de Twitter por palabra clave

Indica una palabra clave de búsqueda de Twitter y un recuento esperado para obtener identificadores de publicaciones públicas coincidentes, fechas de publicación y metadatos de recopilación.

Traducido · es-ESVer texto original

Desarrollador
Precios
Desde 0,002 US$ / 20 registros
Última actualización
2026-11-17

Descripción general

Investigar cómo aparece un tema en la búsqueda de Twitter suele empezar por reunir un conjunto fiable de identificadores de publicaciones y de las fechas en que se publicaron. Esta app convierte una palabra clave de búsqueda en una colección estructurada de elementos coincidentes y conserva la palabra clave y el contexto de recopilación junto a cada identificador para que el conjunto de datos siga siendo comprensible tras exportarlo o cruzarlo con otro material.

El resultado sirve como índice de descubrimiento: muestra qué publicaciones públicas estaban asociadas a una marca, un producto, un tema o una campaña en el momento de la recopilación. Es especialmente adecuada para crear conjuntos de seguimiento repetibles, comparar las poblaciones de contenido encontradas para distintos términos y preparar identificadores para un análisis posterior sin copiar elementos a mano desde las páginas de búsqueda.

Notas sobre los datos

Cada registro representa una publicación de Twitter asociada a la palabra clave enviada, o un indicador sin datos de esa búsqueda. Los ID de contenido se deduplican en el conjunto devuelto. Palabra clave coincidente, Elemento de origen e ID de negocio conservan el contexto de recopilación y pueden repetirse en muchos registros de la misma búsqueda. Fecha de publicación, Hora de recopilación y Hora de limpieza se devuelven sin zona horaria, así que no deben tratarse como marcas de tiempo absolutas entre regiones sin contexto adicional. El tipo de palabra clave describe la clase de elemento de búsqueda asociado al registro.

La colección contiene identificadores, marcas de tiempo y metadatos de recopilación, no el texto de la publicación, medios, totales de interacción, comentarios ni un perfil de autor completo. Un indicador sin datos distingue los metadatos de búsqueda sin contenido coincidente de los registros coincidentes ordinarios. El contenido de Twitter privado, eliminado o no buscable no está cubierto.

Ejemplo de resultado

Cada fila es una publicación de Twitter coincidente o un indicador sin datos asociado a la palabra clave de búsqueda.

ID de contenidoPalabra clave coincidenteFecha de publicaciónHora de recopilaciónIndicador sin datos
2092504987695714392shokz2026-03-17T15:43:442026-08-26T18:50:22No
2092527502547927469shokz2025-12-19T17:41:092026-08-26T18:50:22No

El tipo de palabra clave, el ID de registro recopilado, el ID de negocio, el elemento de origen y la hora de limpieza también están disponibles cuando se suministran con el registro.

Casos de uso

  • Para el descubrimiento de temas, agrupa las filas por Palabra clave coincidente y cuenta los valores distintos de ID de contenido para comparar la población de publicaciones buscables asociada a cada término.
  • Para el seguimiento, repite una recopilación por palabra clave y compara conjuntos de ID de contenido, usando Fecha de publicación y Hora de recopilación como contexto de origen para elementos recién observados.
  • Para comprobar la procedencia, compara Palabra clave coincidente, Elemento de origen e ID de negocio antes de combinar conjuntos de datos.
  • Para la revisión posterior, filtra por Indicador sin datos para separar metadatos de búsqueda vacía de registros coincidentes utilizables.

Alcance y límites

Una palabra clave de búsqueda de Twitter por tarea, con un recuento esperado de 1 a 2000; los resultados se devuelven en lotes completos de 20 y pueden redondearse al alza; la protección de extracción cubre 100 páginas o 2000 registros; la cobertura se limita a listados públicos de búsqueda por palabra clave en Twitter.

  • Adecuada para
  • Cuando necesites identificadores de publicaciones públicas de Twitter y fechas de publicación devueltos por una búsqueda por palabra clave de una marca, producto, tema o campaña.
  • Cuando necesites una lista estructurada que conecte cada publicación coincidente con su palabra clave de búsqueda y los metadatos de recopilación.
  • No usar para
  • Cuando necesites el texto de la publicación, medios, métricas de interacción, comentarios o perfiles de autor completos.
  • Cuando necesites una consulta inmediata de un solo registro en lugar de una recopilación en segundo plano.

Gestión de fallos

Comportamiento de fallos y reintentos declarado por el desarrollador. Recomendamos incluirlo en tu prompt del sistema al integrar.

  1. 1Si no se devuelven registros coincidentes, verifica la palabra clave o prueba una frase más corta y amplia.
  2. 2Conserva los registros completados tras un éxito parcial; vuelve a enviar la misma entrada después de una tarea fallida o caducada.
  3. 3Reintenta más tarde tras un límite de frecuencia, una indisponibilidad temporal o un tiempo de espera.
  4. 4Si falla la autenticación, verifica la clave API configurada en el entorno de ejecución.

Entrada

Parámetros necesarios para llamar a esta App, generados a partir del input.schema del manifest.json.

  • Palabra clave de búsquedakeywordObligatoriostring
    Marca, producto, tema o frase para buscar en Twitter. Cada tarea acepta una palabra clave de 1 a 512 caracteres.
    EjemploShokz
  • Recuento esperado de resultadoscrawl_countObligatoriointeger
    Número esperado de resultados de búsqueda, de 1 a 2000. Los resultados se devuelven en lotes completos de 20, así que el recuento real puede redondearse al alza. Un lote parcial se factura igualmente como 20 registros.
    Rango1–2000Ejemplo1
  • Filtro de idiomalanguageOpcionalstring(enum)
    Código de idioma opcional: en, ja, zh, ko, es, fr, de, pt, ar o hi.
    Valores permitidosp. ej. en (English) / ja (Japanese) / zh (Chinese) / ko (Korean) / es (Spanish) / fr (French) / de (German) / pt (Portuguese) … (10 valores en total; se pueden buscar en el formulario de prueba)
  • Fecha inicialsinceOpcionalstring
    Fecha inicial opcional e inclusiva en formato AAAA-MM-DD.
  • Fecha finaluntilOpcionalstring
    Fecha final opcional e inclusiva en formato AAAA-MM-DD.

Salida

Estructura de campos de un único registro, generada a partir del output.schema del manifest.json.

  • ID de contenidocontent_idstring
    Identificador único de la publicación de Twitter coincidente.
    Ejemplo2092504987695714392
  • Palabra clave coincidentekeywordstring
    Palabra clave de búsqueda asociada a la publicación recopilada.
    Ejemploshokz
  • Tipo de palabra clavekeyword_typestring
    Clasificación del elemento de búsqueda asociado al registro.
    Ejemplokeyword
  • Fecha de publicaciónpublish_timestring
    Marca de tiempo de publicación de la publicación; la fuente no especifica zona horaria.
    Ejemplo2026-03-17T15:43:44

Datos de ejemplo

Generado a partir de output.schema. Los campos sin valor de ejemplo usan marcadores de estructura.

output.example
{
  "content_id": "2092504987695714392",
  "keyword": "shokz",
  "keyword_type": "keyword",
  "publish_time": "2026-03-17T15:43:44",
  "crawl_time": "2026-08-26T18:50:22",
  "clean_update_time": "2026-08-26T18:50:45",
  "cur_id": "6a8ec50697a2800ddeb6901f",
  "biz_id": "shokz",
  "source_item": "shokz",
  "no_data": false
}

Integración

Esta App se puede integrar mediante MCP, API, SDK o exportación de archivos — todos los canales comparten las mismas capacidades y precios. Cada solicitud se autentica con la cabecera Authorization: Bearer usando una API Key (de larga duración, creada en la consola de Data Hub); los clientes MCP también pueden iniciar sesión con OAuth sin clave. Más opciones como CLI y Skill están en camino. Esta App se ejecuta de forma asíncrona y se puede cancelar a mitad de camino: Tras la cancelación, la ejecución se detiene. Los registros ya entregados se conservan y se facturan.

Con MCP (Model Context Protocol) puedes llamar a esta App directamente desde clientes de IA como Claude y Cursor. Elige tu cliente y el modo de autenticación, y copia la configuración de abajo.

Configuración del cliente

Sustituye el valor tras Bearer por tu API Key de larga duración. Funciona en cualquier cliente, CI o entorno sin interfaz.

mcpServers config
{
  "mcpServers": {
    "octoparse_datahub": {
      "type": "http",
      "url": "https://mcp-v2.octoparse.com?pin=hello_moto/twitter-keyword-list",
      "headers": { "Authorization": "Bearer <YOUR_API_KEY>" }
    }
  }
}

Deja que la IA lo configure por ti

¿No quieres editar configuraciones a mano? Copia el prompt de instalación y pégalo en cualquier cliente de IA: completará la configuración a su manera. (De forma predeterminada te guía para iniciar sesión y nunca te pide que envíes tu API Key en el chat.)

detail.access.mcp.composeHint

Precios

20 registros devueltos

Se cobra según el número de registros devueltos correctamente. Las ejecuciones fallidas no se cobran. Se factura en unidades de 20 registros; cualquier unidad parcial se redondea a 20 registros.

0,002 US$/ 20 registros
Per task submitted

Se cobra una vez por cada ejecución enviada, independientemente del número de registros devueltos.

0,0001 US$/ ejecución

Los distintos eventos de facturación se acumulan de forma independiente. Consulta cada elemento para más detalles. Las ejecuciones fallidas no se cobran.

Ver créditos

Pruébalo ahora

Rellena los parámetros y ejecuta — los resultados provienen de una llamada real.

Ejemplo
Los parámetros se validan contra input.schema antes del envío
Desde 0,002 US$ / 20 registros