# Particle · Ranking countries

Find companies, people and contact details with Particle · Ranking countries from Alexandria through one Spiral API key. Use to find the country codes the chart capabilities take. It runs in the background and returns structured JSON. Pay as you go, with no subscription.

- Provider: Alexandria
- Category: Lead Gen
- Runs: In the background
- Returns: json
- Tool id: `alexandria` / `particle/rankings/countries`
- Page: https://spiral.ai/tools/alexandria/particle/rankings/countries

## Pricing

$0.026189 per call.

## Limits

- Longest queue wait: 1 hour
- Run deadline: 5 minutes
- Longest run, end to end: 225 minutes
- Largest inline input: 1 MB
- Largest input file: 2 GB
- Largest output: 5 GB

## Input

| Field | Kind | Allowed | Default | Description |
| --- | --- | --- | --- | --- |
| `limit` | number | 1 to 100 | — | Maximum records to return. Omit for all of them. |
| `cursor` | text |  | — | Opaque cursor from a previous page. Omit for the first page; send the same filters with it. |
| `source` | one of | apple, spotify | — | Ranking source platform. |

## Example

```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": "particle/rankings/countries",
    "input": {
      "limit": 1
    }
  }'
```

Try it in the Playground: https://spiral.ai/start?provider=alexandria&model=particle%2Frankings%2Fcountries

## Common questions

### Particle · Ranking countries

**How much does Particle · Ranking countries cost?**

$0.026189 per call. You pay as you go from one Spiral balance, with no subscription, and a failed run is not charged.

**How do I use Particle · Ranking countries through an API?**

Send `POST /v1/runs` with `"provider": "alexandria"`, `"model": "particle/rankings/countries"` and the input fields on this page, using one Spiral API key. It runs in the background: poll the run, or name a webhook to be told when it finishes.

**Do I need an account with Alexandria to use Particle · Ranking countries?**

No. Spiral runs it on its own Alexandria account and charges your Spiral balance.

**Can my AI agent use Particle · Ranking countries?**

Yes. Agents find and run it through Spiral's MCP server, CLI or agent skill, with the same API key.

