Reddit Keyword Search
Give one Reddit search keyword and an expected count to get matching public post titles, authors, links, and timestamps.
Original · en-USVolver a la traducción
Descripción general
Brand, product, and issue conversations on Reddit often show up first as searchable posts: a title, an author, a link, and a publish time. This app turns one search keyword into a structured list of those public posts so research, monitoring, and competitive review can start from a consistent table instead of a manually copied search page.
The dataset is a discovery index rather than a full post archive. It keeps the search keyword beside each post so later exports still show why an item was collected, and it includes the listing URL captured with the result. That makes it easier to compare how different terms surface, and to open the original post when a title is worth a closer look.
Data notes
Each record is one public Reddit post associated with the submitted keyword, or a no-data marker for that search. Post IDs are de-duplicated within the returned dataset. Keyword, Task item, and Business ID preserve the collection context and may repeat across many rows from the same search. Search listing URL is the captured search-listing address, not necessarily a subreddit name. Publish time and Collection time are returned without timezone information. Result type describes the kind of search item attached to the record. Result page is the listing page index supplied with the row.
The collection includes titles, authors, post links, timestamps, and collection metadata. It does not include post body text, comments, media, or engagement counts. Private, deleted, quarantined, or otherwise non-searchable Reddit content is not covered.
What a result looks like
Each row is one matched Reddit post or a no-data marker associated with the search keyword.
| Post ID | Post title | Author | Publish time | Keyword |
|---|---|---|---|---|
| t3_1w6sq6a | Tesla Model Y L Owners Report Rear Suspension Collapse | Dragonlance12 | 2026-09-04T03:17:46 | Tesla |
| t3_1w6snrz | Emblem on Tesla's | wanderbobphx | 2026-09-04T03:14:27 | Tesla |
Post URL, Collection time, Result page, Search listing URL, Business ID, Result type, Task item, and No-data marker are also available when supplied with the record.
Use cases
- For topic discovery, group rows by Keyword and count distinct Post ID values to compare how many public posts each term surfaces.
- For monitoring, repeat a collection and compare Post ID sets, using Publish time and Collection time as source-provided context for newly observed posts.
- For qualitative review, scan Post title and Author, then open Post URL for posts that mention a product issue or campaign.
- For provenance checks, compare Keyword, Task item, and Business ID before combining collections, and filter on No-data marker to separate empty-search metadata from usable posts.
Alcance y límites
One Reddit search keyword per task with an expected result count from 1 to 300; results are returned in complete batches of 6 and may be rounded up; fetch protection covers 15 pages or 300 records; coverage is limited to public Reddit keyword search listings.
- Adecuada para
- When you need public Reddit post titles, authors, links, and timestamps returned by a keyword search for a brand, product, topic, or campaign.
- When you need a structured list that keeps each matched post together with the search keyword and collection metadata.
- No usar para
- When you need post body text, comments, media, or engagement metrics.
- 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 autor. Recomendamos incluirlo en tu prompt del sistema al integrar.
- 1If no matching records are returned, verify the keyword or try a shorter and broader search phrase.
- 2Keep completed records after a partial success; resubmit the same input after a failed or expired task.
- 3Retry later after rate limiting, temporary service unavailability, or a timeout.
- 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.
| Campo | Nombre de negocio | Tipo | Obligatorio | Predeterminado | Enum / Restricciones | Ejemplo | Descripción |
|---|---|---|---|---|---|---|---|
| keyword | Search keyword | string | Sí | — | — | Tesla | A brand, product, topic, or phrase to search on Reddit. Each task accepts one keyword from 1 to 512 characters. |
| crawl_count | Expected result count | integer | Sí | — | 1–300 | 1 | Expected number of search results, from 1 to 300. Results are returned in complete batches of 6, so the actual count may be rounded up. A partial batch is still billed as 6 records. |
| order_type | Sort order | string(enum) | No | New | New / Relevance / Hot / Top | — | Controls how Reddit search results are ordered. If omitted, the default is New. |
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 | Post ID | string | t3_1w6sq6a | Unique identifier of the matched Reddit post. |
| account_name | Author | string | Dragonlance12 | Reddit username shown as the post author. |
| biz_id | Business ID | string | Tesla | Business grouping identifier returned with the collected record. |
| content_title | Post title | string | Tesla Model Y L Owners Report Rear Suspension Collapse | Title of the matched Reddit post. |
| content_url | Post URL | string | https://www.reddit.com/r/TSLAsexy/comments/1w6sq6a/tesla_model_y_l_owners_report_rear_suspension/ | Public URL of the matched Reddit post. |
| crawl_time | Collection time | string | 2026-09-04T11:19:49 | Timestamp associated with collecting the record; the source does not specify a timezone. |
| keyword | Keyword | string | Tesla | Search keyword associated with the collected post. |
| page_number | Result page | integer | 1 | Listing page index supplied with the collected row. |
| publish_time | Publish time | string | 2026-09-04T03:17:46 | Timestamp when the post was published; the source does not specify a timezone. |
| subreddit_name | Search listing URL | string | https://www.reddit.com/search/?q=Tesla&sort=new&restrict_sr=&t=all | Captured search-listing address returned with the record; it is not necessarily a subreddit name. |
| result_type | Result type | string | keyword | Classification of the search item associated with the record. |
| task_item | Task item | string | Tesla | Keyword item associated with the collection that produced this record. |
| no_data | No-data marker | boolean | false | Indicates whether this search item produced no matching records. |
Schema del registro
La salida se devuelve registro a registro. detail.output.idFieldHint
{
"type": "object",
"properties": {
"content_id": {
"type": "string",
"title": "Post ID",
"description": "Unique identifier of the matched Reddit post.",
"prefill": "t3_1w6sq6a"
},
"account_name": {
"type": "string",
"title": "Author",
"description": "Reddit username shown as the post author.",
"prefill": "Dragonlance12"
},
"biz_id": {
"type": "string",
"title": "Business ID",
"description": "Business grouping identifier returned with the collected record.",
"prefill": "Tesla"
},
"content_title": {
"type": "string",
"title": "Post title",
"description": "Title of the matched Reddit post.",
"prefill": "Tesla Model Y L Owners Report Rear Suspension Collapse"
},
"content_url": {
"type": "string",
"title": "Post URL",
"description": "Public URL of the matched Reddit post.",
"prefill": "https://www.reddit.com/r/TSLAsexy/comments/1w6sq6a/tesla_model_y_l_owners_report_rear_suspension/"
},
"crawl_time": {
"type": "string",
"title": "Collection time",
"description": "Timestamp associated with collecting the record; the source does not specify a timezone.",
"prefill": "2026-09-04T11:19:49"
},
"keyword": {
"type": "string",
"title": "Keyword",
"description": "Search keyword associated with the collected post.",
"prefill": "Tesla"
},
"page_number": {
"type": "integer",
"title": "Result page",
"description": "Listing page index supplied with the collected row.",
"prefill": 1
},
"publish_time": {
"type": "string",
"title": "Publish time",
"description": "Timestamp when the post was published; the source does not specify a timezone.",
"prefill": "2026-09-04T03:17:46"
},
"subreddit_name": {
"type": "string",
"title": "Search listing URL",
"description": "Captured search-listing address returned with the record; it is not necessarily a subreddit name.",
"prefill": "https://www.reddit.com/search/?q=Tesla&sort=new&restrict_sr=&t=all"
},
"result_type": {
"type": "string",
"title": "Result type",
"description": "Classification of the search item associated with the record.",
"prefill": "keyword"
},
"task_item": {
"type": "string",
"title": "Task item",
"description": "Keyword item associated with the collection that produced this record.",
"prefill": "Tesla"
},
"no_data": {
"type": "boolean",
"title": "No-data marker",
"description": "Indicates whether this search item produced no matching records.",
"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": {
"hello_moto__reddit-keyword-list": {
"type": "http",
"url": "https://mcp-v2.octoparse.com?pin=hello_moto/reddit-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. (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
Se cobra según el número de registros devueltos correctamente. Las ejecuciones fallidas no se cobran. Se factura en unidades de 6 registro; cualquier unidad parcial se redondea a 6 registro.
Se cobra una vez por cada ejecución enviada, independientemente del número de registros devueltos.
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éditosPruébalo ahora
Rellena los parámetros y ejecuta — los resultados provienen de una llamada real.