[Integrations](https://spiral.ai/integrations) › [Codex](https://spiral.ai/integrations/codex) › [Particle podcast trend chart](https://spiral.ai/integrations/codex/particle-podcast-trend-chart)

# How to Use Particle podcast trend chart in Codex

Fetch one podcast trend chart with ranked subjects, coverage counts, movement, and explanations when available. Use it to investigate rising movies, games, sports stories, or podcast guests.

|  |  |
| --- | --- |
| Model | Particle podcast trend chart |
| Available through | Alexandria |
| Category | Lead Gen |
| Price | $0.087295 per call. |
| Returns | json |
| Runs | In the background |
| Setup | About 2 minutes, no API key |

## Prompts to try with Particle podcast trend chart in Codex

- Use Particle podcast trend chart for movies to build a table in this project showing the top 20 titles, positions, and coverage counts.
- Use Particle podcast trend chart for NFL coverage to add a view of the top 10 subjects and their movement since the previous edition.
- Use Particle podcast trend chart for video games to create an internal report of the top 10 titles and any available explanations.
- Use Particle podcast trend chart to look this up and give me the result as a table. Save the result in ./assets.
- Pull the latest numbers from Particle podcast trend chart and tell me what changed since last week.

## How to set up Particle podcast trend chart 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 Particle podcast trend chart**: 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": "alexandria",
    "model": "particle/charts/chart",
    "input": {
      "category": "<category>"
    }
  }'
```

Then paste one of the prompts above: Codex finds Particle podcast trend chart on Spiral, shows the price and runs it.

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

## Particle podcast trend chart tools and prices

- [Particle · Entity chart edition](https://spiral.ai/tools/alexandria/particle/charts/chart) (Alexandria): $0.087295 per call.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| sort | rank, acceleration | rank | rank as published, or acceleration to reorder by each entry's growth multiple, fastest first. |
| limit | 1 to 100 | 10 | Ranked entries to return from rank 1 down. |
| window | 7d, 24h | 7d | Measurement window of the edition. Composite charts (all, all-entertainment, all-sports) publish 7d only. |
| include |  | — | Optional sections, comma-separated: timeseries for each entry's daily history, driven_by for the entry whose coverage drives a derivative one. |

## What can you do with Particle podcast trend chart in Codex?

Build an internal editorial panel showing which subjects lead Particle's podcast charts. A coding agent can turn directory summaries and detailed standings into views that help editors choose stories.

### Choose an entertainment newsletter lead

Scan the movie, television, and gaming leaders, then examine a promising subject's chart movement and available explanation before choosing an editorial angle.

### Prepare a sports editorial meeting

Review league chart leaders, then investigate the teams, players, and events behind the strongest candidate stories.

### Research public guests for booking

Check who leads the guest chart, then compare public guests by the number of distinct shows on which they appeared.

### Review attention around a game launch

Check the video game chart leader and inspect the detailed standings for a released title. Use its podcast coverage as one input to an internal launch review.

### Maintain an internal daily briefing

Collect category leaders and selected detailed charts for an internal editorial briefing. Compare successive editions to identify changes worth investigating.

### Prioritize publicity research

Find which entertainment categories have relevant leaders, then inspect charted titles and available explanations to choose where a publicity team should investigate further.

## Overview

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

## Particle podcast trend chart in other agents

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

## More Codex guides

- [Particle podcast transcript preview](https://spiral.ai/integrations/codex/particle-podcast-transcript-preview)
- [Particle public profile links](https://spiral.ai/integrations/codex/particle-public-profile-links)
- [Particle podcast transcript mentions](https://spiral.ai/integrations/codex/particle-podcast-transcript-mentions)
- [Particle public speaker biography](https://spiral.ai/integrations/codex/particle-public-speaker-biography)
- [Particle podcast topic taxonomy](https://spiral.ai/integrations/codex/particle-podcast-topic-taxonomy)
- [Particle publisher assessed shows](https://spiral.ai/integrations/codex/particle-publisher-assessed-shows)

## Questions about Particle podcast trend chart in Codex

**Can Codex use Particle podcast trend chart?**

Yes. Add Spiral to Codex as an MCP server, and Codex can find and run Particle podcast trend chart like any built-in tool.

**How much does Particle podcast trend chart cost in Codex?**

$0.087295 per call. 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 an Alexandria account to use Particle podcast trend chart in Codex?**

No. Spiral runs Particle podcast trend chart on its own Alexandria account. You sign in to Spiral once and never paste a key.

**How long does it take to set up Particle podcast trend chart in Codex?**

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

**Does Codex wait while Particle podcast trend chart runs?**

Particle podcast trend chart runs in the background. Codex starts the run, checks on it and gives you the json when it's ready.

**How broad is Particle's podcast coverage?**

Particle advertises more than 165,000 searchable podcasts. That corpus size does not establish complete coverage of every show or its historical episodes.

**How often do the podcast charts change?**

Rankings and counts update once a day. Explanations can fill in afterward, so an edition can gain context without changing its positions.

**Does first place mean the most mentions?**

Particle measures unusual increases against each subject's own history, rather than ranking solely by mention totals. The guest chart uses a different measure: distinct shows on which someone appeared.

**Do advertising mentions count?**

Particle's mention charts count organic dialogue outside ad reads. A brand's advertising activity therefore does not directly represent its position in these charts.

**How much detail can I retrieve?**

The directory gives edition summaries and first-place subjects. A detailed chart returns up to 100 entries, and neither response uses cursor pagination.

