How to Use Data Legion company workforce search in Codex
Returns matching company profiles with workforce analytics, including employee growth, hiring, departures, and monthly headcount history. Use it to find businesses by workforce characteristics and compare their trends.
Prompts to try with Data Legion company workforce search in Codex
Copy an example into Codex, or ask in your own words.
Use Data Legion company workforce search to find US software companies with positive employee growth over the available 12-month window and add their returned workforce metrics to this project's research view.
Use Data Legion company workforce search to look this up and give me the result as a table. Save the result in ./assets.
Pull the latest numbers from Data Legion company workforce search and tell me what changed since last week.
Check Data Legion company workforce search and summarize what you find in three bullet points.
Pull the newest data from Data Legion company workforce search and give me the result as a table.
How to set up Data Legion company workforce search in Codex
Pick the way that suits you. Each takes about two minutes.
Use Spiral's MCP server
- Add the hosted server
codex mcp add spiral --url https://api.spiral.ai/mcp
- 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
- Send Codex this message
Your agent reads Spiral's skill and sets itself up.
set up https://spiral.ai/SKILL.md
- Sign in or paste a key
Approve Spiral in the browser, or give the agent a key from the console.
Use the Spiral CLI
- 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
- Create an API key
In the console, under API keys.
- Run Data Legion company workforce 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": "datalegion/companies/search-premium", "input": { "query": "<query>" } }'
Then paste one of the prompts above: Codex finds Data Legion company workforce search on Spiral, shows the price and runs it.
Data Legion company workforce search providers and prices
Spiral runs Data Legion company workforce search through Alexandria. Open a card for today's price, with every fee included.
Settings you can ask for
Ask Codex for any of these in your prompt.
| Setting | Allowed values | Default | Description |
|---|---|---|---|
| Limit | 1 to 3 | 1 | Rows to return, in place of a LIMIT clause. Default 1. This product stops at 3 so the quote stays within 125 credits. The vendor's own maximum is 100. |
| Offset | 0 to 10000 | 0 | Rows to skip. 0 to 10000. Ordering can change between Data Legion builds. |
| Titlecase | on or off | When true, Data Legion title-cases display text. Identifiers, URLs, and codes stay as stored. | |
| Pretty print | on or off | When true, Data Legion indents the JSON body. |
Every API field of Data Legion · Company search (premium) is on its tool page: open its card above.
What can you do with Data Legion company workforce search in Codex?
Build a company comparison table in your app from Data Legion's industries, size ranges, founding years, domains, and offices. An agent can map returned profiles into your project's account records and add workforce history where available.
Fill gaps in CRM accounts
Add industry, size range, founding year, domains, and office details to business accounts. Look up known companies or search for records that match your account criteria.
Prepare company research briefs
Build a brief from company descriptions, industries, founding years, websites, and social profiles. Use the returned business details to prepare for a customer or partner meeting.
Compare a business shortlist
Put prospective customers, suppliers, or partners side by side using company type, industry, size range, and founding year. Use lookups for a named shortlist or search to assemble candidates.
Review business territories
Organize companies by their returned headquarters and office locations. Separate headquarters from other offices when deciding which businesses belong in a territory review.
Monitor company workforce trends
Compare monthly headcount, hiring, departures, growth, and turnover for known businesses or a selected market. Review the available history before describing a change as a trend.
Compare workforce composition
Compare companies by their aggregate seniority, job function, tenure, and education distributions. Use the results for employer research or business due diligence.
More on Data Legion company workforce search and Codex
Overview
Data Legion company workforce search in other agents
Questions about Data Legion company workforce search in Codex
Can Codex use Data Legion company workforce search?
Yes. Add Spiral to Codex as an MCP server, and Codex can find and run Data Legion company workforce search like any built-in tool.
How much does Data Legion company workforce search cost in Codex?
Up to $0.209508 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 an Alexandria account to use Data Legion company workforce search in Codex?
No. Spiral runs Data Legion company workforce 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 Data Legion company workforce search in Codex?
About two minutes: add the hosted server, then sign in.
Does Codex wait while Data Legion company workforce search runs?
Data Legion company workforce search runs in the background. Codex starts the run, checks on it and gives you the json when it's ready.
How many companies does Data Legion cover?
Data Legion's published coverage exceeds 71 million company profiles. Coverage varies by field: its statistics page reports a primary website domain on 52% of records.
How often does Data Legion refresh company data?
Data Legion rebuilds its full dataset monthly. That is the published refresh schedule for the underlying company data.
Does Data Legion collect information from private accounts?
Data Legion says its records come from publicly available and commercially licensed sources. Its sourcing policy explicitly excludes scraping private accounts.
Can I distinguish headquarters from other offices?
Company locations identify the primary office as headquarters and indicate whether each office is still operating. That lets you distinguish a headquarters address from another office in the returned profile.
How much workforce history does Data Legion provide?
Premium company records can contain up to 60 months of headcount, hires, and departures. The series ends at the dataset's as-of month.
Start using Data Legion company workforce search in Codex
One Spiral account for every tool your agent needs. No subscription; you pay per run.
Paste this into Codex:
set up https://spiral.ai/SKILL.md


