EN

Reddit Keyword Search

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

Developer
Pricing
From $0.005 / 6 records
Last updated
2026-10-16

Overview

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, sort order, and time range 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.

Each task can choose a sort order and time range. 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 IDPost titleAuthorPublish timeKeyword
t3_1w6sq6aTesla Model Y L Owners Report Rear Suspension CollapseDragonlance122026-09-04T03:17:46Tesla
t3_1w6snrzEmblem on Tesla'swanderbobphx2026-09-04T03:14:27Tesla

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.

Scope and boundaries

One Reddit search keyword per task with an expected result count from 1 to 300; sort order and time range can be selected; 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.

  • Good for
  • When you need public Reddit post titles, authors, links, and timestamps from a keyword search with a chosen sort order and time range 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.
  • Do not use for
  • 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.

Failure handling

Failure and retry behavior declared by the developer. We recommend including it in your system prompt when integrating.

  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.

Input

Parameters required to call this App, generated from the input.schema in manifest.json.

  • Search keywordkeywordRequiredstring
    A brand, product, topic, or phrase to search on Reddit. Each task accepts one keyword from 1 to 512 characters.
    ExampleTesla
  • Expected result countcrawl_countRequiredinteger
    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.
    Range1–300Example1
  • Sort orderorder_typeOptionalstring(enum)
    Controls how Reddit search results are ordered. If omitted, the default is New. Supported choices include Relevance, Hot, New, Top, and most comments.
    Allowed valuesNewRelevanceHotTopMost commentsmostCommentsDefaultNew
  • Time rangetime_filterOptionalstring(enum)
    Limits the Reddit search time range. If omitted, the default is All time.
    Allowed valuesAll timePast yearPast monthPast weekTodayPast hourDefaultAll time

Output

Field structure of a single record, generated from the output.schema in manifest.json.

  • Post IDcontent_idstring
    Unique identifier of the matched Reddit post.
    Examplet3_1w6sq6a
  • Authoraccount_namestring
    Reddit username shown as the post author.
    ExampleDragonlance12
  • Business IDbiz_idstring
    Business grouping identifier returned with the collected record.
    ExampleTesla
  • Post titlecontent_titlestring
    Title of the matched Reddit post.
    ExampleTesla Model Y L Owners Report Rear Suspension Collapse

Sample data

Generated from output.schema. Fields without a sample value use structural placeholders.

output.example
{
  "content_id": "t3_1w6sq6a",
  "account_name": "Dragonlance12",
  "biz_id": "Tesla",
  "content_title": "Tesla Model Y L Owners Report Rear Suspension Collapse",
  "content_url": "https://www.reddit.com/r/TSLAsexy/comments/1w6sq6a/tesla_model_y_l_owners_report_rear_suspension/",
  "crawl_time": "2026-09-04T11:19:49",
  "keyword": "Tesla",
  "page_number": 1,
  "publish_time": "2026-09-04T03:17:46",
  "subreddit_name": "https://www.reddit.com/search/?q=Tesla&sort=new&restrict_sr=&t=all",
  "result_type": "keyword",
  "task_item": "Tesla",
  "no_data": false
}

Integration

This App can be integrated via MCP, API, SDK, or file export. All channels share the same capabilities and pricing. Every request authenticates with the Authorization: Bearer header using an API key (long-lived, created in the Data Hub Console); MCP clients can also sign in with OAuth, no key required. More options such as CLI and Skill are on the way. This App runs asynchronously and can be canceled midway: After you cancel, the run stops. Records already delivered are kept and billed.

With the MCP (Model Context Protocol), you can call this App directly from AI clients like Claude and Cursor. Pick your client and auth mode, then copy the config below.

Client config

Replace the value after Bearer with your long-lived API key. Works in any client, CI, or headless environment.

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

Let AI set it up for you

Don't want to edit configs by hand? Copy the install prompt and paste it into any AI client. It will complete the setup its own way. (By default it guides you through signing in, and never asks you to send your API key in the chat.)

detail.access.mcp.composeHint

Pricing

6 returned records

Charged by the number of records successfully returned. Failed runs are not charged. Billed in units of 6 records; any partial unit is rounded up to 6 records.

$0.005/ 6 records
Per task submitted

Charged once per submitted run, regardless of how many records are returned.

$0.0001/ run

Multiple billing events accumulate independently. See each item for details. Failed runs are not charged.

View credits

Try it now

Fill in the parameters and run. Results come from a real call.

Example
Parameters are validated against input.schema before submission
From $0.005 / 6 records