Reddit search API for AI assistants

The Reddit search API takes a keyword or phrase and returns matching posts, each with its title, the text, the subreddit name, the author handle, and the post score. Your assistant uses it to find what people are discussing about a topic or to check recent conversations.

What it does

You pass a search query, and you can set the time range, the sort order, and whether to search all of Reddit or one subreddit. The provider returns the posts that match, with the title, the post text or link, the subreddit it was posted in, the author handle, when it was posted, and the score and comment count.

Some providers add the top comment or the flair, and each post comes with its Reddit link, so your assistant can follow it to read the full thread.

How a Joshu assistant uses it

When you ask what people think about a product or a topic, Joshu searches Reddit and returns the three or four most upvoted or recent posts, each with a line on why it matters.

Before you post or reply in a subreddit, Joshu checks what the recent posts and top discussions are about, so you know what the community cares about.

When researching a niche topic, Joshu pulls the top Reddit posts from the last month and picks out the most useful links and insights.

Choosing a provider

Providers differ in which subreddits they cover and in how they rank results. Some return only highly upvoted posts, and some show the newest posts first.

curl https://hello.joshu.me/api/router/call \
  -H "Authorization: Bearer $JOSHU_ROUTER_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "endpoint": "crawl4ai.reddit.search.posts",
    "params": {
      "query": "async runtime"
    }
  }'