[Integrations](https://spiral.ai/integrations) › [Codex](https://spiral.ai/integrations/codex) › [Affiliate.com merchant search](https://spiral.ai/integrations/codex/affiliate-com-merchant-search)

# How to Use Affiliate.com merchant search in Codex

Find merchant records and compare their networks, domains, logos, and listed product counts. Use it to build a retailer shortlist or identify the right record before retrieving a merchant profile.

|  |  |
| --- | --- |
| Model | Affiliate.com merchant search |
| Available through | Alexandria |
| Category | SEO |
| Price | $0.043648 per call. |
| Returns | json |
| Runs | In the background |
| Setup | About 2 minutes, no API key |

## Prompts to try with Affiliate.com merchant search in Codex

- Use Affiliate.com merchant search to find records matching bestbuy.com, then add the returned names, domains, networks, and product counts to a review table in this project.
- Use Affiliate.com merchant search to look up Walmart, Target, and Best Buy. Write a JSON report of the matching merchant IDs, domains, networks, and listed product counts.
- Use Affiliate.com merchant search to find records matching realfoodhub.co.uk and build a directory entry from the returned description, domain, logo, and network.
- Use Affiliate.com merchant search to look this up and give me the result as a table. Save the result in ./assets.
- Pull the latest numbers from Affiliate.com merchant search and tell me what changed since last week.

## How to set up Affiliate.com merchant search in Codex

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

### Use Spiral's MCP server

1. **Add the hosted server**

```bash
codex mcp add spiral --url https://api.spiral.ai/mcp
```

2. **Sign in**: Codex opens the browser: sign in to Spiral and click Authorize. No API key. `codex mcp list` then shows Spiral.

```bash
codex mcp login spiral
```

### Use the Spiral skill

1. **Send Codex 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 Affiliate.com merchant 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": "affiliate-com/merchants/search",
    "input": {
      "page": 1
    }
  }'
```

Then paste one of the prompts above: Codex finds Affiliate.com merchant search on Spiral, shows the price and runs it.

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

## Affiliate.com merchant search tools and prices

- [Affiliate.com · Search merchants](https://spiral.ai/tools/alexandria/affiliate-com/merchants/search) (Alexandria): $0.043648 per call.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| page | 1 to … | — | Page number, starting at 1. |
| fields |  | — | Comma-separated field names to keep in each record, for example `id,name,logo_url`. Omit for every field. |
| search |  | — | Case-insensitive fragment of the merchant name or home_url, for example `Walmart` or `walmart.com`. Does not match IDs. |
| per_page | 1 to 50 | — | Merchants per page, 1 to 50. Defaults to 10 here; merchant records are large. |
| countries |  | — | Comma-separated ISO 3166-1 alpha-2 codes the merchant operates in, for example `US,CA`. |
| currencies |  | — | Comma-separated ISO 4217 codes. |

## What can you do with Affiliate.com merchant search in Codex?

Build a retailer directory populated with Affiliate.com merchant names, domains, logos, and network details. A coding agent can connect those records to the project's merchant tables and show listed catalog sizes beside each retailer.

### Check retailers before assigning a buying guide

Find the retailers proposed for a buying guide, then inspect their merchant records. Give editors the matching domains, networks, and listed product counts before they choose where to research products.

### Build a merchant directory

Assemble retailer entries with names, descriptions, domains, and logos. Use individual profiles to review the records selected for publication.

### Prepare a partnership shortlist

Research public retail brands and compare their affiliate network associations and listed catalog sizes. Turn the results into a shortlist for the partnerships team.

### Map merchant and network IDs

Match retailer names and domains to merchant records, then retain the returned merchant and network identifiers for editorial briefs and downstream reporting joins.

### Review catalog depth

Compare listed product counts for candidate retailers and inspect the selected profiles. Use the counts to prioritize product research without treating them as live stock totals.

### Monitor merchant directory changes

Compare repeated merchant lookups with earlier results to flag changes in descriptions, domains, logos, network associations, and listed product counts for review.

## Overview

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

## Affiliate.com merchant search in other agents

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

## More Codex guides

- [Affiliate.com merchant profile](https://spiral.ai/integrations/codex/affiliate-com-merchant-profile)
- [Affiliate.com network brands](https://spiral.ai/integrations/codex/affiliate-com-network-brands)
- [Affiliate.com barcode to Amazon ASIN](https://spiral.ai/integrations/codex/affiliate-com-barcode-to-amazon-asin)
- [Affiliate.com network details](https://spiral.ai/integrations/codex/affiliate-com-network-details)
- [Affiliate.com Amazon ASIN to barcode](https://spiral.ai/integrations/codex/affiliate-com-amazon-asin-to-barcode)
- [Affiliate.com network directory](https://spiral.ai/integrations/codex/affiliate-com-network-directory)

## Questions about Affiliate.com merchant search in Codex

**Can Codex use Affiliate.com merchant search?**

Yes. Add Spiral to Codex as an MCP server, and Codex can find and run Affiliate.com merchant search like any built-in tool.

**How much does Affiliate.com merchant search cost in Codex?**

$0.043648 per call. 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 Affiliate.com merchant search in Codex?**

No. Spiral runs Affiliate.com merchant 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 Affiliate.com merchant search in Codex?**

About two minutes: add the hosted server, then sign in.

**Does Codex wait while Affiliate.com merchant search runs?**

Affiliate.com merchant search runs in the background. Codex starts the run, checks on it and gives you the json when it's ready.

**What information does Affiliate.com provide about a merchant?**

The documented merchant profile includes its name, description, domains, logos, listed product count, and affiliate network. Merchant records describe the retailer and its catalog presence rather than individual product offers.

**Where does Affiliate.com's catalog data come from?**

Affiliate.com accesses merchant product feeds through affiliate networks, then normalizes and structures them. Its network coverage spans more than 30 networks.

**Does Affiliate.com include every retailer?**

No. Affiliate.com says it only indexes data from merchants that have approved it as a publisher, so coverage depends on those merchant relationships.

**Does a merchant's product count mean those items are available now?**

Product count is the number of listed products, which Affiliate.com describes as a way to size catalog opportunity. Its merchant lookup guidance treats that count as a snapshot.

**How fresh is the underlying catalog?**

Affiliate.com says product feeds update daily, and some merchants or networks update more often. That published cadence applies to product feeds; it does not establish how often merchant descriptions, logos, or other profile details change.

