[Integrations](https://spiral.ai/integrations) › [goose](https://spiral.ai/integrations/goose) › [X creator search](https://spiral.ai/integrations/goose/x-creator-search)

# How to Use X creator search in goose

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.

|  |  |
| --- | --- |
| Model | X creator search |
| Available through | Alexandria |
| Category | Social Media |
| Price | Up to $3.2595953 per run. |
| Returns | json |
| Runs | In the background |
| Setup | About 2 minutes, no API key |

## Prompts to try with X creator search in goose

- Use X creator search to find public creators covering software development in the United States, then populate our internal shortlist with their returned profiles.
- 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 goose

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

### Use Spiral's MCP server

1. **Add the extension**: In goose Desktop, open the sidebar, click Extensions, then Add custom extension. Enter:

2. **Sign in**: When goose first connects to Spiral, your browser opens. Sign in to Spiral, pick the organization and click Authorize. No API key. If the browser does not open, goose prints the link to open yourself.

### Use the Spiral skill

1. **Send goose 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 X creator search**: 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": "influencers-club/x/creators-search",
    "input": {
      "paging": {},
      "filters": {}
    }
  }'
```

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

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

## X creator search tools and prices

- [Influencers.club · Search X creators](https://spiral.ai/tools/alexandria/influencers-club/x/creators-search) (Alexandria): Up to $3.2595953 per run.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| sort |  | — | Platform-specific sort object from the upstream request contract. |
| nlp_search |  | — | nlp search |
| return_filter_values |  | — | return filter values |

## What can you do with X creator search in goose?

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.

## Overview

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

## X creator search in other agents

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

## More goose guides

- [X creator profile](https://spiral.ai/integrations/goose/x-creator-profile)
- [X follow relationship](https://spiral.ai/integrations/goose/x-follow-relationship)
- [X creator connected accounts](https://spiral.ai/integrations/goose/x-creator-connected-accounts)
- [X latest post replies](https://spiral.ai/integrations/goose/x-latest-post-replies)
- [X community tweets](https://spiral.ai/integrations/goose/x-community-tweets)
- [X list followers](https://spiral.ai/integrations/goose/x-list-followers)

## Questions about X creator search in goose

**Can goose use X creator search?**

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

**How much does X creator search cost in goose?**

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 goose plan is separate.

**Do I need an Alexandria account to use X creator search in goose?**

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 goose?**

About two minutes: add the extension, then sign in.

**Does goose wait while X creator search runs?**

X creator search runs in the background. goose 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.

