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

AlexandriaSEOAvailable now

Affiliate.com · Search merchants

affiliate-com/merchants/search

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.

Pricing

$0.043648 per call.

Limits

Runs
In the background
Returns
json
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

FieldKindDefaultDescription
pagenumber
1 to …
—

Page number, starting at 1.

fieldstext—

Comma-separated field names to keep in each record, for example id,name,logo_url. Omit for every field.

searchtext—

Case-insensitive fragment of the merchant name or home_url, for example Walmart or walmart.com. Does not match IDs.

per_pagenumber
1 to 50
—

Merchants per page, 1 to 50. Defaults to 10 here; merchant records are large.

countriestext—

Comma-separated ISO 3166-1 alpha-2 codes the merchant operates in, for example US,CA.

currenciestext—

Comma-separated ISO 4217 codes.

origin_idstext—

Comma-separated merchant IDs as the source network assigns them.

network_idstext—

Comma-separated numeric network IDs, as in a merchant's network.id.

category_idstext—

Comma-separated cat_ category IDs.

canonical_idstext—

Comma-separated canonical mer_ merchant IDs.

category_nametext—

Category name filter.

feed_languagestext—

Comma-separated ISO 639-1 codes of the product feed.

merchant_typestext—

Comma-separated: standard, asn (Amazon Seller Network).

countries_markettext—

Comma-separated codes for the merchant's market countries.

countries_origintext—

Comma-separated codes for the merchant's origin country.

product_count_maxnumber
0 to …
—

Only merchants with at most this many products.

product_count_minnumber
0 to …
—

Only merchants with at least this many products.

promotion_count_maxnumber
0 to …
—

Only merchants with at most this many promotions.

promotion_count_minnumber
0 to …
—

Only merchants with at least this many promotions.

has_commissionable_urlone of
1
—

1 keeps only merchants with a stored commissionable URL template. Not a test for linkability: read providers[].template instead.

Same request in code

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
    }
  }'

Frequently asked questions

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.