[Integrations](https://spiral.ai/integrations) › [Codex](https://spiral.ai/integrations/codex) › [Fanatics product search](https://spiral.ai/integrations/codex/fanatics-product-search)

# How to Use Fanatics product search in Codex

Find Fanatics merchandise through the storefront's keyword search, with facets for narrowing results. Use it when you have a team, player, or product phrase rather than a specific item.

|  |  |
| --- | --- |
| Model | Fanatics product search |
| Available through | Alexandria |
| Category | E-commerce |
| Price | $0.00873 per call. |
| Returns | json |
| Runs | In the background |
| Setup | About 2 minutes, no API key |

## Prompts to try with Fanatics product search in Codex

- Use Fanatics product search for “Boston Celtics hoodie” and adapt this project's results component to the returned data.
- Use Fanatics product search for “Los Angeles Lakers jersey” and check whether this project's parser handles the returned facets.
- Use Fanatics product search to look this up and give me the result as a table. Save the result in ./assets.
- Pull the latest numbers from Fanatics product search and tell me what changed since last week.
- Check Fanatics product search and summarize what you find in three bullet points.

## How to set up Fanatics product 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 Fanatics product 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": "fanatics-com/products/search_products",
    "input": {
      "query": "<query>"
    }
  }'
```

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

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

## Fanatics product search tools and prices

- [Fanatics US · Search products](https://spiral.ai/tools/alexandria/fanatics-com/products/search_products) (Alexandria): $0.00873 per call.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| page | 1 to 200 | 1 | 1-based page number (the site's pageNumber). |
| sort | TopSellers, NewestArrivals, LowestPrice, HighestPrice | TopSellers | Sort order (the site's sortOption values). |
| page_size | 1 to 96 | 24 | Products per page (the site's pageSize). The storefront UI offers 24, 48, 72 and 96. |
| include_facets |  | — | Include the site's facet groups (leagues, departments, players, brands, price bands) with their option URLs. Set false for a smaller result when only the products matter. |

## What can you do with Fanatics product search in Codex?

Build a personal Fanatics merchandise browser with team navigation and product inspection. Coding agents can use the storefront responses to implement browsing behavior in your project.

### Build a personal league shopping shortlist

Identify teams in the Fanatics directory, browse their merchandise, search for specific styles, and check sizes on the final candidates.

### Compare gear for rival teams

Find the Lakers and Celtics in the team directory, compare their merchandise sections, search for matching product styles, and inspect shortlisted items.

### Plan college sports gifts

Locate college teams, browse each school's merchandise, search for requested apparel, and check the available sizes before choosing gifts.

### Explore unfamiliar team shops

Use the league directory to choose teams beyond your usual favorites. Browse their sections, search for preferred merchandise styles, and inspect individual products.

### Find alternatives to an unavailable size

Search for the same team and apparel type, browse the relevant merchandise section, and check size-level stock on alternative products.

## Overview

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

## Fanatics product search in other agents

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

## More Codex guides

- [Fanatics product details](https://spiral.ai/integrations/codex/fanatics-product-details)
- [Fanatics team and league products](https://spiral.ai/integrations/codex/fanatics-team-and-league-products)
- [Facebook Marketplace location search](https://spiral.ai/integrations/codex/facebook-marketplace-location-search)
- [Fanatics team directory](https://spiral.ai/integrations/codex/fanatics-team-directory)
- [Facebook Marketplace listing search](https://spiral.ai/integrations/codex/facebook-marketplace-listing-search)
- [Flipp local retailer flyers](https://spiral.ai/integrations/codex/flipp-local-retailer-flyers)

## Questions about Fanatics product search in Codex

**Can Codex use Fanatics product search?**

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

**How much does Fanatics product search cost in Codex?**

$0.00873 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 Fanatics product search in Codex?**

No. Spiral runs Fanatics product 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 Fanatics product search in Codex?**

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

**Does Codex wait while Fanatics product search runs?**

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

**Which Fanatics store does this data cover?**

The documented source is the US storefront at fanatics.com. Its merchandise data comes from the storefront's server-rendered pages and Iris data API.

**How fresh is Fanatics merchandise information?**

Fanatics says its website updates daily but does not specify fixed update times. That statement does not establish a minute-by-minute freshness guarantee.

**Does Fanatics show a complete archive of unavailable merchandise?**

Fanatics says it displays items currently in stock. The storefront should therefore be used to explore its current assortment rather than as a complete archive of past merchandise.

**Can an item be listed while my size is unavailable?**

Yes. Fanatics marks unavailable sizes by graying them out on the product page, so finding a listing does not establish availability in your size.

**Do Fanatics' terms permit commercial extraction of storefront data?**

Fanatics lists automated extraction for commercial purposes, including screen scraping, among unauthorized uses. Public visibility should not be treated as permission for commercial extraction.

