JP

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.

原文 · en-US訳文に戻す

開発者
料金
$0.005 / 6 件から
最終更新
2026-10-16

概要

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.

適用範囲と境界

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.

  • 適している用途
  • 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.
  • 適さない用途
  • 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.

失敗時の処理

開発者が宣言した失敗時と再試行の動作です。連携時にはシステムプロンプトに含めることをおすすめします。

  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.

入力

この App の呼び出しに必要なパラメータで、manifest.json の input.schema から生成されています。

  • Search keywordkeyword必須string
    A brand, product, topic, or phrase to search on Reddit. Each task accepts one keyword from 1 to 512 characters.
    例Tesla
  • Expected result countcrawl_count必須integer
    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.
    範囲1–300例1
  • Sort orderorder_type任意string(enum)
    Controls how Reddit search results are ordered. If omitted, the default is New. Supported choices include Relevance, Hot, New, Top, and most comments.
    選択可能な値NewRelevanceHotTopMost commentsmostCommentsデフォルトNew
  • Time rangetime_filter任意string(enum)
    Limits the Reddit search time range. If omitted, the default is All time.
    選択可能な値All timePast yearPast monthPast weekTodayPast hourデフォルトAll time

出力

1 件のレコードのフィールド構造で、manifest.json の output.schema から生成されています。

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

サンプルデータ

output.schema から生成したサンプルです。サンプル値のないフィールドには構造上のプレースホルダーを使用しています。

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
}

連携方法

この App は MCP、API、SDK、ファイルエクスポートのいずれでも連携でき、どのチャネルも同じ能力と料金を共有します。すべてのリクエストは Authorization: Bearer ヘッダーで認証し、認証情報には API Key(長期有効。Data Hub コンソールで作成)を使用します。MCP クライアントは OAuth によるキー不要のログインにも対応しています。CLI や Skill など、さらに多くの連携方法も準備中です。 この App は非同期で実行され、途中でキャンセルできます:キャンセル後、実行は停止します。納品済みのレコードは保持され、課金対象になります。

MCP(Model Context Protocol)を使うと、Claude や Cursor などの AI クライアントからこの App を直接呼び出せます。クライアントと認証方式を選び、下の設定をコピーしてください。

クライアント設定

Bearer の後の値を長期有効な API Key に置き換えてください。あらゆるクライアント、CI、ヘッドレス環境で利用できます。

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

AI に設定を任せる

設定を手作業で編集したくない場合は、インストールプロンプトをコピーして任意の AI クライアントに貼り付けてください。AI が自分のやり方でセットアップを完了します(デフォルトではログインを案内し、API Key をチャットに送るよう求めることはありません)。

detail.access.mcp.composeHint

料金

6 returned records

正常に返されたレコードの件数に応じて課金されます。失敗した実行には課金されません。 6 件を 1 つの課金単位とし、端数は 6 件に切り上げて課金されます。

$0.005/ 6 件
Per task submitted

返される件数にかかわらず、実行の送信 1 回ごとに課金されます。

$0.0001/ 回

複数の課金イベントはそれぞれ独立して累計されます。詳細は各項目をご覧ください。失敗した実行には課金されません。

Credits を確認

今すぐ試す

パラメータを入力して実行してください。結果は実際の呼び出しによるものです。

サンプル
パラメータは送信前に input.schema で検証されます
$0.005 / 6 件から