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

Codex · Social Media

How to Use YouTube channel profile in Codex

Returns a channel's identity, public subscriber total, video and view totals, and linked websites or social accounts. Use it to assess a known creator or brand before researching its content.

Prompts to try with YouTube channel profile in Codex

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

Use YouTube channel profile for @NASA and add its name, public subscriber total, and published links to the channel directory in this project.

YouTube channel profileCodex
Try asking
  • Use YouTube channel profile for @Google and @Microsoft, then populate a comparison table with their public subscriber, video, and view totals.

  • Scrape https://example.com/pricing with YouTube channel profile and turn it into a comparison table. Save the result in ./assets.

  • Crawl the docs at https://docs.example.com with YouTube channel profile and summarize each section.

  • Pull the latest posts from this blog with YouTube channel profile and list their titles and dates.

How to set up YouTube channel profile 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 YouTube channel profile

    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": "scrapecreators",
        "model": "scrapecreators/youtube-channel",
        "input": {
          "url": "https://www.youtube.com/@ThePatMcAfeeShow"
        }
      }'

Then paste one of the prompts above: Codex finds YouTube channel profile on Spiral, shows the price and runs it.

YouTube channel profile providers and prices

Spiral runs YouTube channel profile through ScrapeCreators. Open a card for today's price, with every fee included.

ScrapeCreatorsSocial Media
YouTube · Channel Details
scrapecreators/youtube-channel

Settings you can ask for

Ask Codex for any of these in your prompt.

SettingAllowed valuesDefaultDescription
Cache max age1d, 3d, 7d, 14d, or 30d

If we have a response in the cache that is this many days old or newer, return the cached response (0 credits, with "cached": true and a "cached_at" timestamp). Otherwise, scrape a live result (1 credit). See the Caching page for details.

Every API field of YouTube · Channel Details is on its tool page: open its card above.

What can you do with YouTube channel profile in Codex?

Build a YouTube research panel for public brands and creators. A coding agent can turn channel profiles or topic matches into structured project data and a readable view.

Creator partnership research

Compare public channel totals for a creator shortlist, then find each creator's content about the proposed campaign topic.

Competitor channel briefs

Pair competing brands' channel statistics with links to their content about a shared product category.

Public channel directory

Create directory entries from channel identities and published links, with selected topic matches to help readers choose what to watch.

Editorial source research

Identify the publishing channel behind a research source and collect its relevant videos, broadcasts, Shorts, and playlists for editorial review.

Weekly channel reports

Compare repeated channel snapshots and topic searches to report changes in public totals and newly encountered content links.

Learning resource selection

Compare educational channels using their public profiles, then assemble topic-specific viewing lists from matching content.

Questions about YouTube channel profile in Codex

Can Codex use YouTube channel profile?

Yes. Add Spiral to Codex as an MCP server, and Codex can find and run YouTube channel profile like any built-in tool.

How much does YouTube channel profile cost in Codex?

Up to $0.0013 per run. 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 ScrapeCreators account to use YouTube channel profile in Codex?

No. Spiral runs YouTube channel profile on its own ScrapeCreators account. You sign in to Spiral once and never paste a key.

How long does it take to set up YouTube channel profile in Codex?

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

Does Codex wait while YouTube channel profile runs?

YouTube channel profile runs in the background. Codex starts the run, checks on it and gives you the json when it's ready.

What information can these YouTube lookups access?

ScrapeCreators describes its source as publicly available information from third-party websites. These lookups cover public channel information and searchable content.

Does public channel research include private videos?

Private videos do not appear in YouTube search. Unlisted videos generally stay out of search too, although YouTube notes an exception when someone adds one to a public playlist.

Are public subscriber totals exact?

YouTube shortens public subscriber totals. A channel with 1 million to just under 10 million subscribers has a displayed total that changes in steps of 10,000.

What does a channel's country tell me?

The profile response can include one channel country, alongside its public links. That field describes the channel record; it does not establish where its viewers live.

Can keyword research cover more than standard videos?

YouTube channel content search can return four content types: videos, Shorts, live streams, and playlists. A topic brief should consider each returned collection.

Get started

Start using YouTube channel profile 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