ES

Twitter Keyword Search

Give one Twitter search keyword and an expected count to get matching public post identifiers, publish times, and collection metadata.

Original · en-USVolver a la traducción

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

Descripción general

Researching how a topic appears in Twitter search often starts with a dependable set of matching post identifiers and the times those posts were published. This app turns one search keyword into a structured collection of matching items, keeping the keyword and collection context beside each identifier so the dataset remains understandable after it is exported or joined with other research material.

The result is useful as a discovery index: it shows which public posts were associated with a brand, product, topic, or campaign at collection time. It is especially suited to building repeatable monitoring sets, comparing the content populations found for different terms, and preparing identifiers for later analysis without manually copying items from search pages.

Data notes

Each record represents one Twitter post associated with the submitted search keyword, or a no-data marker for that search. Content IDs are de-duplicated within the returned dataset. Matched keyword, Source item, and Business ID preserve the collection context and may repeat across many records from the same search. Publish time, Collection time, and Clean update time are returned without timezone information, so they should not be treated as absolute cross-region timestamps without additional context. Keyword type describes the kind of search item attached to the record.

The collection contains identifiers, timestamps, and collection metadata, not post text, media, engagement totals, comments, or a complete author profile. A No-data marker distinguishes search metadata that reports no matching content from ordinary matched records. Private, deleted, or otherwise non-searchable Twitter content is not covered.

What a result looks like

Each row is one matched Twitter post or a no-data marker associated with the search keyword.

Content IDMatched keywordPublish timeCollection timeNo-data marker
2092504987695714392shokz2026-03-17T15:43:442026-08-26T18:50:22No
2092527502547927469shokz2025-12-19T17:41:092026-08-26T18:50:22No

Keyword type, Collection record ID, Business ID, Source item, and Clean update time are also available when supplied with the record.

Use cases

  • For topic discovery, group rows by Matched keyword and count distinct Content ID values to compare the searchable post population associated with each term.
  • For monitoring, repeat a keyword collection and compare Content ID sets while using Publish time and Collection time as source-provided context for newly observed items.
  • For provenance checks, compare Matched keyword, Source item, and Business ID to confirm which search context produced each post before combining datasets.
  • For follow-up review, filter on No-data marker to separate empty-search metadata from usable matched records.

Alcance y límites

One Twitter search keyword per task with an expected result count from 1 to 2000; results are returned in complete batches of 20 and may be rounded up; fetch protection covers 100 pages or 2000 records; coverage is limited to public Twitter keyword search listings.

  • Adecuada para
  • When you need public Twitter post identifiers and publish times returned by a keyword search for a brand, product, topic, or campaign.
  • When you need a structured list that connects each matched post with its search keyword and collection metadata.
  • No usar para
  • When you need post text, media, engagement metrics, comments, or complete author profiles.
  • When you need an immediate single-record lookup rather than a background keyword collection task.

Gestión de fallos

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

  1. 1If no matching records are returned, verify the keyword or try a shorter and broader search phrase.
  2. 2Keep completed records after a partial success; resubmit the same input after a failed or expired task.
  3. 3Retry later after rate limiting, temporary service unavailability, or a timeout.
  4. 4If authentication fails, verify the API Key configured for the execution environment.

Entrada

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

  • Search keywordkeywordObligatoriostring
    A brand, product, topic, or phrase to search on Twitter. Each task accepts one keyword from 1 to 512 characters.
    EjemploShokz
  • Expected result countcrawl_countObligatoriointeger
    Expected number of search results, from 1 to 2000. Results are returned in complete batches of 20, so the actual count may be rounded up. A partial batch is still billed as 20 records.
    Rango1–2000Ejemplo1
  • Language filterlanguageOpcionalstring(enum)
    Optional language code: en, ja, zh, ko, es, fr, de, pt, ar, or 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)
  • Start datesinceOpcionalstring
    Optional inclusive start date in YYYY-MM-DD format.
  • End dateuntilOpcionalstring
    Optional inclusive end date in YYYY-MM-DD format.

Salida

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

  • Content IDcontent_idstring
    Unique identifier of the matched Twitter post.
    Ejemplo2092504987695714392
  • Matched keywordkeywordstring
    Search keyword associated with the collected post.
    Ejemploshokz
  • Keyword typekeyword_typestring
    Classification of the search item associated with the record.
    Ejemplokeyword
  • Publish timepublish_timestring
    Timestamp when the post was published; the source does not specify a timezone.
    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 returned records

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