[Integrations](https://spiral.ai/integrations) › [Codex](https://spiral.ai/integrations/codex) › [Reddit search results](https://spiral.ai/integrations/codex/reddit-search-results)

# How to Use Reddit search results in Codex

Returns Reddit matches for posts, communities, comments, media, or users. Use it to find discussions about a specific product or topic instead of browsing recommended feeds.

|  |  |
| --- | --- |
| Model | Reddit search results |
| Available through | TikHub |
| Category | Social Media |
| Price | $0.0013 per request. |
| Returns | json |
| Runs | In the background |
| Setup | About 2 minutes, no API key |

## Prompts to try with Reddit search results in Codex

- Use Reddit search results for subreddit:rust title:"borrow checker" and add a results view to this project using the returned posts.
- Use Reddit search results to look this up and give me the result as a table. Save the result in ./assets.
- Pull the latest numbers from Reddit search results and tell me what changed since last week.
- Check Reddit search results and summarize what you find in three bullet points.
- Pull the newest data from Reddit search results and give me the result as a table.

## How to set up Reddit search results in Codex

Pick the way that suits you. Each takes about two minutes.

### Use Spiral's MCP server

1. **Add the hosted server**

```bash
codex mcp add spiral --url https://api.spiral.ai/mcp
```

2. **Sign in**: Codex opens the browser: sign in to Spiral and click Authorize. No API key. `codex mcp list` then shows Spiral.

```bash
codex mcp login spiral
```

### Use the Spiral skill

1. **Send Codex this message**: Your agent reads Spiral's skill and sets itself up.

```
set up https://spiral.ai/SKILL.md
```

2. **Sign in or paste a key**: Approve Spiral in the browser, or give the agent a key from the console.

### Use the Spiral CLI

1. **Install and sign in**: Installs the Spiral CLI, signs you in and adds its skill to your coding agents.

```bash
npx -y spiral-cli@latest init
```

### Call the Spiral API

1. **Create an API key**: In the console, under API keys.

2. **Run Reddit search results**: One request; the result comes back by polling or a webhook.

```bash
curl https://api.spiral.ai/v1/runs \
  -H "Authorization: Bearer $SPIRAL_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "provider": "tikhub",
    "model": "tikhub/reddit-app-fetch-dynamic-search",
    "input": {
      "query": "<query>"
    }
  }'
```

Then paste one of the prompts above: Codex finds Reddit search results on Spiral, shows the price and runs it.

Setup guide in the docs: https://spiral.ai/docs/quickstarts/codex

## Reddit search results tools and prices

- [Reddit App · Fetch Reddit APP Dynamic Search Results](https://spiral.ai/tools/tikhub/tikhub/reddit-app-fetch-dynamic-search) (TikHub): $0.0013 per request.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| sort | RELEVANCE, HOT, TOP, NEW, COMMENTS | — |  |
| after |  |  | Pagination cursor; use pageInfo.endCursor when need_format=true |
| language |  | en-US | Preferred response language as an IETF language tag; default: en-US |
| allow_nsfw | 0, 1 | 0 | Allow NSFW content: 0, 1 |
| time_range | all, year, month, week, day, hour | — |  |
| need_format |  | false | When true, data contains only children and pageInfo with redundant result fields removed; false preserves the original search structure |

## What can you do with Reddit search results in Codex?

Build a Reddit research reader with views for discovery, post details, and discussion context. Use retrieved Reddit content to populate the corresponding view and test how the project handles pagination and nested replies.

### Prepare gaming launch coverage

Find launch discussions through gaming, news, home, and popular feeds or targeted search. Check community highlights, inspect shortlisted posts individually or in batches, and read comments and replies for reactions worth investigating.

### Build a Reddit discussion reader

Create separate views for recommended feeds, topic searches, and community highlights. Let readers open post details and expand comments and nested replies; retrieve details in batches when populating a shortlist.

### Compare discussion discovery methods

Compare the Steam Deck discussions found through search, community highlights, and each recommended feed. Report overlap and relevant results in the retrieved samples to choose a useful starting point for future research.

### Research gaming hardware feedback

Find Steam Deck discussions through search, gaming recommendations, and community highlights. Read post details, comments, and reply branches to group reported problems and proposed fixes without profiling individual users.

### Check the context behind technology news

Select technology stories from news, home, or popular recommendations, then search for related discussion. Inspect the original posts and comment branches to distinguish the submitted story from commenters' interpretations.

### Draft answers to recurring product questions

Use searches and community highlights to select public product discussions. Compare post details, comments, and nested replies to draft a FAQ that identifies repeated questions and separates suggested fixes from verified documentation.

## Overview

- [TikHub](https://spiral.ai/providers/tikhub)
- [All Codex guides](https://spiral.ai/integrations/codex)

## Reddit search results in other agents

- [Amp](https://spiral.ai/integrations/amp/reddit-search-results)
- [ChatGPT](https://spiral.ai/integrations/chatgpt/reddit-search-results)
- [Claude](https://spiral.ai/integrations/claude-desktop/reddit-search-results)
- [Claude Code](https://spiral.ai/integrations/claude-code/reddit-search-results)
- [Cline](https://spiral.ai/integrations/cline/reddit-search-results)
- [Cursor](https://spiral.ai/integrations/cursor/reddit-search-results)
- [Devin](https://spiral.ai/integrations/devin/reddit-search-results)
- [dots](https://spiral.ai/integrations/dots/reddit-search-results)
- [Factory Droid](https://spiral.ai/integrations/factory-droid/reddit-search-results)
- [Gemini](https://spiral.ai/integrations/gemini/reddit-search-results)
- [Gemini CLI](https://spiral.ai/integrations/gemini-cli/reddit-search-results)
- [Google Antigravity](https://spiral.ai/integrations/antigravity/reddit-search-results)
- [goose](https://spiral.ai/integrations/goose/reddit-search-results)
- [Grok](https://spiral.ai/integrations/grok/reddit-search-results)
- [Grok Build](https://spiral.ai/integrations/grok-build/reddit-search-results)
- [Hermes](https://spiral.ai/integrations/hermes/reddit-search-results)
- [Instinct](https://spiral.ai/integrations/instinct/reddit-search-results)
- [Manus](https://spiral.ai/integrations/manus/reddit-search-results)
- [Muse](https://spiral.ai/integrations/muse/reddit-search-results)
- [Muse Code](https://spiral.ai/integrations/muse-code/reddit-search-results)
- [n8n](https://spiral.ai/integrations/n8n/reddit-search-results)
- [Notion](https://spiral.ai/integrations/notion/reddit-search-results)
- [OpenClaw](https://spiral.ai/integrations/openclaw/reddit-search-results)
- [opencode](https://spiral.ai/integrations/opencode/reddit-search-results)
- [Perplexity](https://spiral.ai/integrations/perplexity/reddit-search-results)
- [Raycast](https://spiral.ai/integrations/raycast/reddit-search-results)
- [VS Code](https://spiral.ai/integrations/vscode/reddit-search-results)
- [Windsurf](https://spiral.ai/integrations/windsurf/reddit-search-results)
- [Zapier](https://spiral.ai/integrations/zapier/reddit-search-results)

## More Codex guides

- [Reddit post details in bulk](https://spiral.ai/integrations/codex/reddit-post-details-in-bulk)
- [Reddit search suggestions](https://spiral.ai/integrations/codex/reddit-search-suggestions)
- [Reddit post details](https://spiral.ai/integrations/codex/reddit-post-details)
- [Reddit subreddit details](https://spiral.ai/integrations/codex/reddit-subreddit-details)
- [Reddit post comments and replies](https://spiral.ai/integrations/codex/reddit-post-comments-and-replies)
- [Reddit subreddit information](https://spiral.ai/integrations/codex/reddit-subreddit-information)

## Questions about Reddit search results in Codex

**Can Codex use Reddit search results?**

Yes. Add Spiral to Codex as an MCP server, and Codex can find and run Reddit search results like any built-in tool.

**How much does Reddit search results cost in Codex?**

$0.0013 per request. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your Codex plan is separate.

**Do I need a TikHub account to use Reddit search results in Codex?**

No. Spiral runs Reddit search results on its own TikHub account. You sign in to Spiral once and never paste a key.

**How long does it take to set up Reddit search results in Codex?**

About two minutes: add the hosted server, then sign in.

**Does Codex wait while Reddit search results runs?**

Reddit search results runs in the background. Codex starts the run, checks on it and gives you the json when it's ready.

**What Reddit content does this cover?**

TikHub describes its service as publicly available social media data. Reddit excludes posts and comments in private or quarantined communities from public content licensing.

**How fresh are the results?**

TikHub says every request retrieves fresh, real-time data, including repeat requests with identical parameters.

**Does Reddit guarantee that the content is accurate?**

Reddit's user agreement disclaims guarantees of completeness, truthfulness, accuracy, and reliability for user content. Product claims and news discussions carry that limitation.

**Can public Reddit content be reused commercially?**

Reddit's public content policy allows noncommercial uses such as learning and community, but says to contact Reddit about commercial purposes.

**What happens when Reddit content is deleted?**

Reddit requires commercial data licensees to stop using or displaying content when users delete it. Reddit also supplies compliance tools that notify those licensees of deletions in real time.

