Reddit Keyword Search

Give one Reddit search keyword and an expected count to get matching public post titles, authors, links, and timestamps.

Source · en-USRevenir à la traduction

Collecte de données Social Media Reddit Posts

Aperçu

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.

Périmètre et limites

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.

Adapté pour
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.

À ne pas utiliser pour
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.

Gestion des échecs

Comportement en cas d'échec et de nouvelle tentative déclaré par l'auteur. Nous vous recommandons de l'inclure dans votre prompt système lors de l'intégration.

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.

Entrée

Paramètres requis pour appeler cette App, générés à partir de l'input.schema du manifest.json.

Champ	Nom métier	Type	Requis	Défaut	Énum / Contraintes	Exemple	Description
keyword	Search keyword	string	Oui	—	—	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	Oui	—	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)	Non	New	New / Relevance / Hot / Top	—	Controls how Reddit search results are ordered. If omitted, the default is New.

Sortie

Structure des champs d'un enregistrement, générée à partir de l'output.schema du manifest.json.

Champ	Nom métier	Type	Exemple	Description
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 de l'enregistrement

La sortie est renvoyée enregistrement par enregistrement. detail.output.idFieldHint

output.schema

{
  "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
}

Intégration

Cette App peut être intégrée via MCP, API, SDK ou export de fichiers — tous les canaux partagent les mêmes capacités et la même tarification. Chaque requête s'authentifie avec l'en-tête Authorization: Bearer à l'aide d'une API Key (longue durée, créée dans la console Data Hub) ; les clients MCP peuvent aussi se connecter via OAuth, sans clé. D'autres options comme la CLI et Skill arrivent bientôt.

Avec MCP (Model Context Protocol), vous pouvez appeler cette App directement depuis des clients IA comme Claude et Cursor. Choisissez votre client et votre mode d'authentification, puis copiez la config ci-dessous.

Config du client

Remplacez la valeur après Bearer par votre API Key longue durée. Fonctionne dans n'importe quel client, en CI ou en environnement sans navigateur.

mcpServers config

{
  "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>" }
    }
  }
}

Voir mes API Keys →

Laissez l'IA tout configurer pour vous

Vous ne voulez pas modifier les configs à la main ? Copiez le prompt d'installation et collez-le dans n'importe quel client IA — il effectuera la configuration à sa manière. (Le prompt demande à l'IA de vous réclamer votre API Key, afin que les identifiants ne finissent jamais dans l'historique de conversation ni dans des configs partagées.)

detail.access.mcp.composeHint

Tarifs

6 returned records

Facturé selon le nombre d'enregistrements renvoyés avec succès. Les exécutions échouées ne sont pas facturées. Facturé par unités de 6 enregistrement ; toute unité incomplète est arrondie à 6 enregistrement.

0,005 $US/ 6 enregistrement

Per task submitted

Facturé une fois par exécution soumise, quel que soit le nombre d'enregistrements renvoyés.

0,0001 $US/ exécution

Plusieurs événements de facturation se cumulent indépendamment. Voir chaque élément pour les détails. Les exécutions échouées ne sont pas facturées.

Voir les crédits

Essayer maintenant

Renseignez les paramètres et lancez l'exécution — les résultats proviennent d'un appel réel.

Exemple

Les paramètres sont validés par rapport à l'input.schema avant la soumission

Search keywordkeyword*A brand, product, topic, or phrase to search on Reddit. Each task accepts one keyword from 1 to 512 characters.

Expected result countcrawl_count*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.

Sort orderorder_type (facultatif)Controls how Reddit search results are ordered. If omitted, the default is New.

Veuillez d'abord renseigner les paramètres requis

À partir de 0,005 $US / 6 enregistrement