Spiral gives your agent every tool with one account. Browse the tools →

Codex · Lead Gen

How to Use Particle publisher category exposure in Codex

Ranks podcast publishers by exposure to one content category, with prevalence, treatment, and example shows. Use it to compare networks against a specific advertising restriction.

Prompts to try with Particle publisher category exposure in Codex

Copy an example into Codex, or ask in your own words.

Use Particle publisher category exposure for drugs, alcohol, and tobacco content and build a table comparing the returned publishers and example shows.

Particle publisher category exposureCodex
Try asking
  • Use Particle publisher category exposure to look this up and give me the result as a table. Save the result in ./assets.

  • Pull the latest numbers from Particle publisher category exposure and tell me what changed since last week.

  • Check Particle publisher category exposure and summarize what you find in three bullet points.

  • Pull the newest data from Particle publisher category exposure and give me the result as a table.

How to set up Particle publisher category exposure in Codex

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

Use Spiral's MCP server

  1. Add the hosted server
    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.

    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.

    npx -y spiral-cli@latest init

Call the Spiral API

  1. Create an API key

    In the console, under API keys.

  2. Run Particle publisher category exposure

    One request; the result comes back by polling or a webhook.

    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/suitability/category-publishers",
        "input": {
          "code": "adult_sexual"
        }
      }'

Then paste one of the prompts above: Codex finds Particle publisher category exposure on Spiral, shows the price and runs it.

Particle publisher category exposure providers and prices

Spiral runs Particle publisher category exposure through Alexandria. Open a card for today's price, with every fee included.

AlexandriaLead Gen
Particle · Publishers by exposure to a category
particle/suitability/category-publishers

Settings you can ask for

Ask Codex for any of these in your prompt.

SettingAllowed valuesDefaultDescription
Codeadult_sexual, arms_ammunition, crime_harmful_acts, death_injury_military_conflict, online_piracy, hate_speech_aggression, obscenity_profanity, illegal_drugs_alcohol_tobacco and 4 more

The brand-safety category to pivot on.

Limit1 to 10025

Maximum records to return.

Directionmost_exposed or least_exposedmost_exposed

most_exposed ranks by exposure share descending; least_exposed inverts it.

TreatmentDOCUMENTARY, EDITORIAL, PROMOTIONAL, or GLAMORIZING

With category: only count exposure whose treatment equals this value.

Min prevalenceINCIDENTAL, OCCASIONAL, FREQUENT, or PERVASIVEINCIDENTAL

With category: only count exposure at or above this prevalence. INCIDENTAL is any non-NONE prevalence.

Min analyzed podcasts1 to 10005

Exclude publishers with fewer analysed shows than this.

Every API field of Particle · Publishers by exposure to a category is on its tool page: open its card above.

What can you do with Particle publisher category exposure in Codex?

Build a podcast placement review into your project's campaign tools using Particle's suitability data. Let the agent turn returned assessments into review tables and briefs tied to your content policy.

Prepare a podcast campaign review

Compare networks, inspect shortlisted catalogs, and examine show evidence against the campaign's content policy. Add appearance context for a public creator being considered for the campaign.

Review alcohol-related content exposure

Compare publisher exposure to drugs, alcohol, and tobacco content, then review the relevant shows and their treatment of the subject. Include the show context surrounding a proposed public spokesperson's appearances.

Assess documentary content for sponsorship

Build a review brief for a history or true-crime sponsorship. Compare network composition, identify flagged shows, inspect documentary treatment and evidence, and describe a public creator's appearance context separately.

Document an agency's placement rationale

Explain why a network, show, or public creator partnership needs further review. Assemble publisher comparisons, category exposure, show evidence, and creator appearance context into a client decision brief.

Find networks for a content-policy review

Compare publisher rankings with exposure to the specific category a brand restricts, then select networks for closer examination.

Questions about Particle publisher category exposure in Codex

Can Codex use Particle publisher category exposure?

Yes. Add Spiral to Codex as an MCP server, and Codex can find and run Particle publisher category exposure like any built-in tool.

How much does Particle publisher category exposure cost in Codex?

$0.043648 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 publisher category exposure in Codex?

No. Spiral runs Particle publisher category exposure 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 publisher category exposure in Codex?

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

Does Codex wait while Particle publisher category exposure runs?

Particle publisher category exposure runs in the background. Codex starts the run, checks on it and gives you the json when it's ready.

Does Particle assess every podcast it indexes?

No. Its publisher documentation reports roughly 10% suitability coverage at the time of writing, with popular shows overrepresented. That percentage describes assessment coverage, not the size of Particle's podcast index.

How often do suitability ratings change?

Underlying show assessments refresh after 25, 20, 15, or 10 new episodes, depending on the prior tier. The maximum age ranges from nine months for UNSAFE to 24 months for SAFE and LIMITED.

Why might an indexed show have no assessment?

A first assessment requires at least five episodes with classified topics. Suitability coverage is also still being backfilled, so an indexed show does not necessarily have a rating.

How much of a show's content does a rating represent?

An assessment covers a sampled episode window across 12 content categories, rather than the show's full catalog. Particle also says treatment classification is most reliable for English-language content.

Where does Particle get the underlying content?

Particle processes publicly available podcast episodes using AI and natural language processing. Its suitability data describes that published content.

Get started

Start using Particle publisher category exposure in Codex

One Spiral account for every tool your agent needs. No subscription; you pay per run.

Paste this into Codex:

Set up Codex

set up https://spiral.ai/SKILL.md
Are you an AI agent? See setup options