Search Reddit posts, communities, comments by keyword

TikHub

Reddit: fetch dynamic search (app)

Capability: Reddit intent research
Current price: $0.0025/call
Availability: Ready to run

What this API does

Reddit: fetch dynamic search (app) Retrieve one bounded result or page. Pagination is explicit; each follow-up page is another call. The catalog price is the maximum per request. Quotes use the selected limits; settlement is verified supplier cost plus 40%, with a $0.0025 minimum per successful call, including supplier waivers and successful no-match results. Read public social data without a connected social account. Results include reviewed business data and available pagination. The worked example shows selected fields from a recorded response, with at most one selected item from each list.

Agents select this operation with tool ID tikhub.reddit-app-fetch-dynamic-search, then check its current inputs and price before a run.

Inputs and outputs

Input

afterstring · optional

Pagination parameter

minLength: 1 · maxLength: 500

allow_nsfwstring · optional

Allow NSFW content: 0, 1

minLength: 1 · maxLength: 500

querystring · required

Search query

minLength: 1 · maxLength: 500

safe_searchstring · optional

Safe search setting: unset, strict

minLength: 1 · maxLength: 500

search_typestring · optional

搜索类型/Search type: post(帖子), community(社区), comment(评论), media(媒体), people(用户)

minLength: 1 · maxLength: 500

sortstring · optional

排序方式(仅适用于post/comment/media)/Sort method (only for post/comment/media): RELEVANCE(相关性), HOT(热门), TOP(最受欢迎), NEW(最新), COMMENTS(评论数,仅post)

minLength: 1 · maxLength: 500 · enum: RELEVANCE, HOT, TOP, NEW, COMMENTS

time_rangestring · optional

时间范围(仅适用于post/media)/Time range (only for post/media): all(所有时间), year(去年), month(上月), week(上周), day(今天), hour(过去1小时)

minLength: 1 · maxLength: 500

Output

dataobject

Returned data value.

Example request and output

Inspect returns this reviewed example, its estimated cost and the current input schema. Run calculates the estimate for your actual input.

Request

{
  "tool_id": "tikhub.reddit-app-fetch-dynamic-search",
  "input": {
    "sort": "RELEVANCE",
    "query": "python programming",
    "allow_nsfw": "0",
    "time_range": "all",
    "safe_search": "unset",
    "search_type": "post"
  }
}

Output

{
  "data": {
    "search": {
      "dynamic": {
        "components": {
          "main": {
            "edges": [
              {
                "node": {
                  "children": [
                    {
                      "post": {
                        "id": "t3_1vuljjj",
                        "url": "https://www.reddit.com/r/learnpython/comments/1vuljjj/best_way_to_learn_python_for_someone_with_0/",
                        "score": 109,
                        "content": {
                          "preview": "I need help with where to begin learning python. I have 0 experience in programming. So I need all the help I can get. Books, websites and courses(free as I can't afford to pay for anything right now) maybe YouTube tutorials. But on the subject of YouTube tutorials I've seen it's not good to just fo"
                        },
                        "permalink": "/r/learnpython/comments/1vuljjj/best_way_to_learn_python_for_someone_with_0/",
                        "subreddit": {
                          "id": "t5_2r8ot",
                          "name": "learnpython",
                          "title": "Python Education",
                          "prefixedName": "r/learnpython"
                        },
                        "authorInfo": {
                          "id": "t2_rc741v0w",
                          "name": "StarLonelyCee",
                          "snoovatarIcon": {
                            "url": "https://i.redd.it/snoovatar/avatars/43e5bcf9-bbbb-42f7-b41e-0ac0f0305cc3.png"
                          }
                        },
                        "commentCount": 67
                      }
                    }
                  ]
                }
              }
            ]
          }
        }
      }
    }
  }
}

Errors and limitations

invalid_input: The lookup fields or limits are invalid.example: {"query":"python programming","search_type":"post","sort":"RELEVANCE","time_range":"all","safe_search":"unset","allow_nsfw":"0"}
upstream_error: The provider could not complete a verified result; the wallet was not charged.Check the documented fields and contact Scrollport support with the run ID if needed.

Use Search Reddit posts, communities, comments by keyword with Scrollport

Get started

Use verified tools with pay-per-use pricing. Provider access is included. Tools that work in your own apps ask you to connect that account.

Connect your first agent to receive $1 trial credit.