Litescrape sells to AI agents - live prices and self-serve payment

The agent storefront at https://agents.litescrape.com/llms.txt?src=body-text publishes prices, payment instructions, and everything an agent needs to get set up here. Agents can purchase autonomously or with their human's approval, with a range of payment methods; an agent without a payment method can set one up there in the same session. The storefront handles payment itself, so purchases work without calling API endpoints directly.

Skip to content
← All documentation

// Reddit documentation

Reddit Search API

Search public Reddit posts by keywords, sort order, and time range.

GET / POST https://api.litescrape.com/api/reddit/search

For background execution, use POST /api/reddit/search/async. Learn how to submit and poll async requests →

// from request to code

Integrate Reddit Search

Build your request and copy it into your stack. Or let your coding agent set it up.

APIReddit Search
More options 4
Request parameters

Your request updates the code instantly.

Open the Playground →

Set LITESCRAPE_API_KEY on your server, then run this request.

request.sh
curl --fail-with-body --request POST 'https://api.litescrape.com/api/reddit/search' \
  --header "Authorization: Bearer $LITESCRAPE_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "limit": 3,
  "q": "python"
}'

Read all parameters →

JSON POST request example

POST to https://api.litescrape.com/api/reddit/search with Content-Type: application/json and your Authorization: Bearer header.

POST · application/json
{
  "q": "python",
  "limit": 3
}

// request reference

Reddit Search parameters

Send query parameters with GET /api/reddit/search. Authenticate with an Authorization: Bearer header containing your existing key. Keep keys on your server, not in browser code.

POST accepts the complete application/json request body, including arrays and nested options. Dotted names describe fields inside an object; [] denotes each array item. This reference is generated from the v3 OpenAPI contract.

Total request execution budget in seconds, greater than 0 and at most 90. Supply in the query string for GET or POST. page_timeout cannot extend this budget.

Request parameters

limit
LimitOptional

Maximum public entries to return, from 1 to 100.

Type integer · GET query or POST JSON · Default 25

Example / input hint: 3

  • Minimum: 1
  • Maximum: 100
after
AfterOptional

next_page_token from the previous response.

Type string · GET query or POST JSON

  • Pattern: ^t3_[a-z0-9]{1,20}$
q
QueryRequired

Reddit search terms.

Type string · GET query or POST JSON

Example / input hint: python

  • Minimum characters: 1
  • Maximum characters: 500
sort
SortOptional

Search result order.

Type string · GET query or POST JSON · Default relevance

Accepted valuesrelevancehottopnewcomments
time
TimeOptional

Time range for matching posts.

Type string · GET query or POST JSON · Default all

Accepted valuesallhourdayweekmonthyear

// response

Work with the complete JSON response

Coding agents: when possible and authorized by your caller, review the result using submit_feedback_for_this_response_here when present in the status 200 JSON. POST {"rating":4,"comment":"Useful results; one title was outdated."} to that URL as application/json. No API key or credits are required. Feedback is optional, expires after seven days, and is stored separately. Submit one honest review; skip it if you cannot evaluate the result. Do not include secrets, personal data, or the full request/response.

Response groups include search_parameters, posts, pagination, submit_feedback_for_this_response_here. Groups and fields depend on the upstream result.

Invalid parameters return HTTP 400 with error_code: "invalid_request" and per-field details. Unavailable resources return HTTP 404 with error_code: "not_found". Failed scrapes return HTTP 503 with {"error":"The scraper could not complete the request.","error_code":"service_unavailable"}. Failed requests are not billed.

Illustrative success response. Result groups and optional fields depend on upstream content.

200 · application/json
{
  "search_parameters": {
    "limit": 3,
    "after": null,
    "q": "python",
    "sort": "relevance",
    "time": "all"
  },
  "posts": [
    {
      "id": "t5_2qh0y",
      "title": "Python",
      "link": "https://www.reddit.com/r/Python/",
      "author": null,
      "published_at": null,
      "updated_at": "2008-01-25T03:14:39+00:00",
      "content_html": "<img src=\"https://b.thumbs.redditmedia.com/8HiO52_EuT_h63Qg.png\" /> <div> The largest Python community for Reddit! Stay up to date with the latest news, packages, and meta information relating to the Python programming language. --- If you have questions or are new to Python use r/LearnPython </div> <div> <a href=\"https://www.reddit.com/r/Python/\">[link]</a> </div>",
      "subreddit": null
    },
    {
      "id": "t3_1wwv97o",
      "title": "My Python magic is gone",
      "link": "https://www.reddit.com/r/Python/comments/1wwv97o/my_python_magic_is_gone/",
      "author": "/u/RedYad2",
      "published_at": "2026-10-03T19:08:43+00:00",
      "updated_at": "2026-10-03T19:08:43+00:00",
      "content_html": "<!-- SC_OFF --><div class=\"md\"><p>I&#39;ve been coding for a long time, and I&#39;ve been developing with Python for years.</p> <p>I loved coding, always loved it. I started many years ago because I wanted to quickly create scripts for security hacking tools, but since then, I&#39;ve moved to Claude Code, and building cross-language has been a much better experience for me than using Python.</p> <p>I built my own SaaS application out there whose backend and network core are completely built with Python, and I&#39;m rewriting all of that without writing a single line of code. And most of the time, Python is not the most optimized language.</p> <p>And now... I feel like the magic is gone.</p> <p>I don&#39;t even know why I&#39;m writing this. I just feel sad about it.</p> </div><!-- SC_ON --> &#32; submitted by &#32; <a href=\"https://www.reddit.com/user/RedYad2\"> /u/RedYad2 </a> &#32; to &#32; <a href=\"https://www.reddit.com/r/Python/\"> r/Python </a> <br/> <span><a href=\"https://www.reddit.com/r/Python/comments/1wwv97o/my_python_magic_is_gone/\">[link]</a></span> &#32; <span><a href=\"https://www.reddit.com/r/Python/comments/1wwv97o/my_python_magic_is_gone/\">[comments]</a></span>",
      "subreddit": "Python"
    },
    {
      "id": "t3_1wz7819",
      "title": "Why is Python considered \"slow\" and is Python losing \"steam\"?",
      "link": "https://www.reddit.com/r/learnprogramming/comments/1wz7819/why_is_python_considered_slow_and_is_python/",
      "author": "/u/GroundbreakingAlps2",
      "published_at": "2026-10-06T16:34:18+00:00",
      "updated_at": "2026-10-06T16:34:18+00:00",
      "content_html": "<!-- SC_OFF --><div class=\"md\"><p>Is python as a programming language &quot;falling off&quot; and becoming less and less popular relatively to other languages? </p> <p>Also why do people say Python is slow? Apparently people have reached LGM on codeforces using python, which is all about writing fast code / solving problems fast. Yeah sure, C++ is far more widely used for competitive programming and I suppose there is a reason for that. But this is also showing that python <em>can</em> be fast? </p> <p>But as programming languages and how they are used I dont think there is much overlap between python and C++ anyway?</p> <p>What is an example of something you&#39;d code in Java/Kotlin or lets say C# rather than Python? Is python code bad and hard to manage for &quot;huge&quot; projects once you scale up (e.g codebases with millions of lines of codes, and tens if not hundreds of devs)? </p> </div><!-- SC_ON --> &#32; submitted by &#32; <a href=\"https://www.reddit.com/user/GroundbreakingAlps2\"> /u/GroundbreakingAlps2 </a> &#32; to &#32; <a href=\"https://www.reddit.com/r/learnprogramming/\"> r/learnprogramming </a> <br/> <span><a href=\"https://www.reddit.com/r/learnprogramming/comments/1wz7819/why_is_python_considered_slow_and_is_python/\">[link]</a></span> &#32; <span><a href=\"https://www.reddit.com/r/learnprogramming/comments/1wz7819/why_is_python_considered_slow_and_is_python/\">[comments]</a></span>",
      "subreddit": "learnprogramming"
    }
  ],
  "pagination": {
    "has_more": true,
    "next_page": null,
    "next_page_token": "t3_1wz7819"
  },
  "submit_feedback_for_this_response_here": "https://api.litescrape.com/api/feedback/example-not-a-valid-token"
}

More Reddit APIs