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

Recopilación de datos Social Media X (Twitter)Posts

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 contenido	Palabra clave coincidente	Fecha de publicación	Hora de recopilación	Indicador sin datos
2092504987695714392	shokz	2026-03-17T15:43:44	2026-08-26T18:50:22	No
2092527502547927469	shokz	2025-12-19T17:41:09	2026-08-26T18:50:22	No

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 autor. Recomendamos incluirlo en tu prompt del sistema al integrar.

1Si no se devuelven registros coincidentes, verifica la palabra clave o prueba una frase más corta y amplia.
2Conserva los registros completados tras un éxito parcial; vuelve a enviar la misma entrada después de una tarea fallida o caducada.
3Reintenta más tarde tras un límite de frecuencia, una indisponibilidad temporal o un tiempo de espera.
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.

Campo	Nombre de negocio	Tipo	Obligatorio	Predeterminado	Enum / Restricciones	Ejemplo	Descripción
keyword	Palabra clave de búsqueda	string	Sí	—	—	Shokz	Marca, producto, tema o frase para buscar en Twitter. Cada tarea acepta una palabra clave de 1 a 512 caracteres.
crawl_count	Recuento esperado de resultados	integer	Sí	—	1–2000	1	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.

Salida

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

Campo	Nombre de negocio	Tipo	Ejemplo	Descripción
content_id	ID de contenido	string	2092504987695714392	Identificador único de la publicación de Twitter coincidente.
keyword	Palabra clave coincidente	string	shokz	Palabra clave de búsqueda asociada a la publicación recopilada.
keyword_type	Tipo de palabra clave	string	keyword	Clasificación del elemento de búsqueda asociado al registro.
publish_time	Fecha de publicación	string	2026-03-17T15:43:44	Marca de tiempo de publicación de la publicación; la fuente no especifica zona horaria.
crawl_time	Hora de recopilación	string	2026-08-26T18:50:22	Marca de tiempo asociada a la recopilación del registro; la fuente no especifica zona horaria.
clean_update_time	Hora de limpieza	string	2026-08-26T18:50:45	Marca de tiempo asociada a la limpieza del registro recopilado; la fuente no especifica zona horaria.
cur_id	ID de registro recopilado	string	6a8ec50697a2800ddeb6901f	Identificador único de esta fila recopilada; puede diferir del ID de contenido de la publicación de Twitter.
biz_id	ID de negocio	string	shokz	Identificador de agrupación empresarial devuelto con el registro recopilado.
source_item	Elemento de origen	string	shokz	Elemento de palabra clave asociado a la recopilación que produjo este registro.
no_data	Indicador sin datos	boolean	false	Indica si este elemento de búsqueda no produjo registros coincidentes.

Schema del registro

La salida se devuelve registro a registro. detail.output.idFieldHint

output.schema

{
  "type": "object",
  "properties": {
    "content_id": {
      "type": "string",
      "title": "ID de contenido",
      "description": "Identificador único de la publicación de Twitter coincidente.",
      "prefill": "2092504987695714392"
    },
    "keyword": {
      "type": "string",
      "title": "Palabra clave coincidente",
      "description": "Palabra clave de búsqueda asociada a la publicación recopilada.",
      "prefill": "shokz"
    },
    "keyword_type": {
      "type": "string",
      "title": "Tipo de palabra clave",
      "description": "Clasificación del elemento de búsqueda asociado al registro.",
      "prefill": "keyword"
    },
    "publish_time": {
      "type": "string",
      "title": "Fecha de publicación",
      "description": "Marca de tiempo de publicación de la publicación; la fuente no especifica zona horaria.",
      "prefill": "2026-03-17T15:43:44"
    },
    "crawl_time": {
      "type": "string",
      "title": "Hora de recopilación",
      "description": "Marca de tiempo asociada a la recopilación del registro; la fuente no especifica zona horaria.",
      "prefill": "2026-08-26T18:50:22"
    },
    "clean_update_time": {
      "type": "string",
      "title": "Hora de limpieza",
      "description": "Marca de tiempo asociada a la limpieza del registro recopilado; la fuente no especifica zona horaria.",
      "prefill": "2026-08-26T18:50:45"
    },
    "cur_id": {
      "type": "string",
      "title": "ID de registro recopilado",
      "description": "Identificador único de esta fila recopilada; puede diferir del ID de contenido de la publicación de Twitter.",
      "prefill": "6a8ec50697a2800ddeb6901f"
    },
    "biz_id": {
      "type": "string",
      "title": "ID de negocio",
      "description": "Identificador de agrupación empresarial devuelto con el registro recopilado.",
      "prefill": "shokz"
    },
    "source_item": {
      "type": "string",
      "title": "Elemento de origen",
      "description": "Elemento de palabra clave asociado a la recopilación que produjo este registro.",
      "prefill": "shokz"
    },
    "no_data": {
      "type": "boolean",
      "title": "Indicador sin datos",
      "description": "Indica si este elemento de búsqueda no produjo registros coincidentes.",
      "prefill": false
    }
  },
  "required": [],
  "additionalProperties": 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.

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": {
    "hello_moto__twitter-keyword-list": {
      "type": "http",
      "url": "https://mcp-v2.octoparse.com?pin=hello_moto/twitter-keyword-list",
      "headers": { "Authorization": "Bearer <YOUR_API_KEY>" }
    }
  }
}

Ver mis API Keys →

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. (El prompt le pide a la IA que te solicite tu API Key, de modo que las credenciales nunca queden en el historial de chat ni en configuraciones compartidas.)

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 registro; cualquier unidad parcial se redondea a 20 registro.

0,002 US$/ 20 registro

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

Palabra clave de búsquedakeyword*Marca, producto, tema o frase para buscar en Twitter. Cada tarea acepta una palabra clave de 1 a 512 caracteres.

Recuento esperado de resultadoscrawl_count*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.

Rellena primero los parámetros obligatorios

Desde 0,002 US$ / 20 registro