# Affiliate.com · Search merchants

Get SEO and search ranking data with Affiliate.com · Search merchants from Alexandria through one Spiral API key. Find retailers and brands across affiliate networks by name or domain, and see which network carries them, how many products they list, their categories and countries, and link templates to fill with your own publisher ID. It runs in the background and returns structured JSON. Pay as you go, with no subscription.

- Provider: Alexandria
- Category: SEO
- Runs: In the background
- Returns: json
- Tool id: `alexandria` / `affiliate-com/merchants/search`
- Page: https://spiral.ai/tools/alexandria/affiliate-com/merchants/search

## Pricing

$0.043648 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 |
| --- | --- | --- | --- | --- |
| `page` | number | 1 to … | — | Page number, starting at 1. |
| `fields` | text |  | — | Comma-separated field names to keep in each record, for example `id,name,logo_url`. Omit for every field. |
| `search` | text |  | — | Case-insensitive fragment of the merchant name or home_url, for example `Walmart` or `walmart.com`. Does not match IDs. |
| `per_page` | number | 1 to 50 | — | Merchants per page, 1 to 50. Defaults to 10 here; merchant records are large. |
| `countries` | text |  | — | Comma-separated ISO 3166-1 alpha-2 codes the merchant operates in, for example `US,CA`. |
| `currencies` | text |  | — | Comma-separated ISO 4217 codes. |
| `origin_ids` | text |  | — | Comma-separated merchant IDs as the source network assigns them. |
| `network_ids` | text |  | — | Comma-separated numeric network IDs, as in a merchant's `network.id`. |
| `category_ids` | text |  | — | Comma-separated `cat_` category IDs. |
| `canonical_ids` | text |  | — | Comma-separated canonical `mer_` merchant IDs. |
| `category_name` | text |  | — | Category name filter. |
| `feed_languages` | text |  | — | Comma-separated ISO 639-1 codes of the product feed. |
| `merchant_types` | text |  | — | Comma-separated: `standard`, `asn` (Amazon Seller Network). |
| `countries_market` | text |  | — | Comma-separated codes for the merchant's market countries. |
| `countries_origin` | text |  | — | Comma-separated codes for the merchant's origin country. |
| `product_count_max` | number | 0 to … | — | Only merchants with at most this many products. |
| `product_count_min` | number | 0 to … | — | Only merchants with at least this many products. |
| `promotion_count_max` | number | 0 to … | — | Only merchants with at most this many promotions. |
| `promotion_count_min` | number | 0 to … | — | Only merchants with at least this many promotions. |
| `has_commissionable_url` | one of | 1 | — | `1` keeps only merchants with a stored commissionable URL template. Not a test for linkability: read providers[].template instead. |

## 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": "affiliate-com/merchants/search",
    "input": {
      "page": 1
    }
  }'
```

Try it in the Playground: https://spiral.ai/start?provider=alexandria&model=affiliate-com%2Fmerchants%2Fsearch

## Common questions

### Affiliate.com · Search merchants

**How much does Affiliate.com · Search merchants cost?**

$0.043648 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 Affiliate.com · Search merchants through an API?**

Send `POST /v1/runs` with `"provider": "alexandria"`, `"model": "affiliate-com/merchants/search"` 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 Affiliate.com · Search merchants?**

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

**Can my AI agent use Affiliate.com · Search merchants?**

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

