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

Gemini CLI · Social Media

How to Use X creator search in Gemini CLI

Returns a paginated list of X creators with profile information, follower counts, and engagement rates. Use it to build a shortlist from a campaign brief before researching individual creators.

Prompts to try with X creator search in Gemini CLI

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

Use X creator search to find public creators covering software development in the United States, then populate our internal shortlist with their returned profiles.

X creator searchGemini CLI
Try asking
  • Use X creator search for English-language photography creators in the United Kingdom and render the returned names, profile links, and follower counts in our project.

  • Use X creator search to look this up and give me the result as a table. Save the result in ./assets.

  • Pull the latest numbers from X creator search and tell me what changed since last week.

  • Check X creator search and summarize what you find in three bullet points.

How to set up X creator search in Gemini CLI

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

Use Spiral's MCP server

  1. Add the server

    Or add it to ~/.gemini/settings.json yourself:

    gemini mcp add --scope user --transport http spiral https://api.spiral.ai/mcp
  2. Sign in

    Start gemini and run:

    /mcp auth spiral
  3. Check it

    In Gemini CLI, run /mcp. From your shell:

    gemini mcp list

Use the Spiral skill

  1. Send Gemini CLI 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 X creator search

    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": "influencers-club/x/creators-search",
        "input": {
          "paging": {},
          "filters": {}
        }
      }'

Then paste one of the prompts above: Gemini CLI finds X creator search on Spiral, shows the price and runs it.

X creator search providers and prices

Spiral runs X creator search through Alexandria. Open a card for today's price, with every fee included.

AlexandriaSocial Media
Influencers.club · Search X creators
influencers-club/x/creators-search

Settings you can ask for

Ask Gemini CLI for any of these in your prompt.

SettingAllowed valuesDefaultDescription
Return filter valueson or off

return filter values

Every API field of Influencers.club · Search X creators is on its tool page: open its card above.

What can you do with X creator search in Gemini CLI?

Build an internal X creator directory with searchable profiles and connected publishing channels. A coding agent can turn the returned creator records into tables and comparison views in your project.

Prepare a sponsorship shortlist

Find X creators for a technology campaign, review their bios and follower counts, and map their connected accounts before choosing candidates.

Research conference speakers

Search for creators covering software development, assess their profile topics, and identify connected channels that could support event promotion.

Build an internal creator directory

Discover creators in a defined niche, add profile details, and attach verified connected accounts to each internal research record.

Plan a campaign across platforms

Find X creators for a product launch, review their profiles, and compare follower counts on their connected accounts to decide which platforms to investigate further.

Questions about X creator search in Gemini CLI

Can Gemini CLI use X creator search?

Yes. Add Spiral to Gemini CLI as an MCP server, and Gemini CLI can find and run X creator search like any built-in tool.

How much does X creator search cost in Gemini CLI?

Up to $3.2595953 per run. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your Gemini CLI plan is separate.

Do I need an Alexandria account to use X creator search in Gemini CLI?

No. Spiral runs X creator search on its own Alexandria account. You sign in to Spiral once and never paste a key.

How long does it take to set up X creator search in Gemini CLI?

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

Does Gemini CLI wait while X creator search runs?

X creator search runs in the background. Gemini CLI starts the run, checks on it and gives you the json when it's ready.

Does Influencers.club include private X information?

The provider says it collects publicly available information and excludes anything behind a login or password wall. These results do not provide access to private X information.

How fresh are the creator records?

Influencers.club says profiles refresh weekly, with faster-changing accounts revisited more often. That schedule does not establish that every X lookup reflects changes made today.

Can a public creator disappear from the database?

Yes. Creators can request removal, and the provider says those removals persist through later refresh cycles.

How many creators can X creator search return at once?

The documented discovery maximum is 200 creators per request. Results use page numbers starting at zero.

Does an X creator profile include audience demographics?

Profile enrichment excludes audience demographics, growth curves, medians, and income estimates. It includes core profile information such as bio, follower counts, verification, and niche classification.

Get started

Start using X creator search in Gemini CLI

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

Paste this into Gemini CLI:

Set up Gemini CLI

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