# market2000.xyz Crawl-to-Refer Ratio

> market2000.xyz Crawl-to-Refer Ratio is a paid API for AI agents from market2000.xyz, paid per call via x402, $5/call, status unknown (last checked 2026-09-15).

Returns per-AI-company statistics on pages crawled versus visitors referred, with the crawl-to-referral ratio, over a configurable lookback window.

## Facts

- Endpoint: GET https://market2000.xyz/api/demand/crawl-to-refer
- Price: $5/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/market2000-xyz-crawl-to-refer-ratio-6bc7dfee
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Y8aA8LaoXyDUtlW4GLbBc

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability market2000-xyz-crawl-to-refer-ratio-6bc7dfee
```

Example prompt: Show me which AI companies crawled my site the most versus how much referral traffic they actually sent back over the last 30 days, and give me the crawl-to-refer ratio for each one.

## When to prefer this

Use this endpoint when you need to understand the reciprocity relationship between AI crawlers and referral traffic at the origin level — data that only the origin can observe. Prefer this over generic SEO tools when the specific question is about AI company crawl behavior versus traffic returned, rather than overall SEO performance or keyword ranking.

## Known failure modes

- days parameter out of range (must be 1-90) returns a validation error
- origin has insufficient crawl data for the requested window, returning sparse or empty by_company array
- mixed-use crawler referrals may be unattributable, flagged with a caveat rather than an error
- payment failure (x402) if USDC payment is not attached or insufficient
- rate limiting if called too frequently

## How this service works

Crawl-to-refer — what each AI company takes from a site versus what it sends back.

Per company: pages crawled, visitors referred, and the ratio between them, measured at an origin's own door. Every publisher wants this number for their own site and cannot compute it without being the origin being crawled.

HOW TO CALL:
  GET /api/demand/crawl-to-refer?days=30

PARAMETERS:
  days — lookback window, 1-90 (default 30)

RESPONSE: by_company[] with crawls, referrals and the ratio, plus an explicit caveat on mixed-use crawlers whose referrals cannot be attributed to search or AI.

PRICING: $0.10 per call.

## Output

An array (by_company) where each entry contains the AI company name, total pages crawled, total visitors referred, and the numeric crawl-to-refer ratio. Also includes an explicit caveat flagging mixed-use crawlers (e.g. those used for both search and AI training) where referral attribution to AI vs search is ambiguous.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method",
    "queryParams"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "properties": {}
    }
   }
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/market2000-xyz-crawl-to-refer-ratio-6bc7dfee/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from market2000.xyz](https://www.zero.xyz/host/market2000.xyz/llms.txt)