Web Research with x402 APIs

STOP — Read before making any API call. enrichx402.com endpoints are not the same as each provider's native API. All paths use the format

https://enrichx402.com/api/{provider}/{action}

. You MUST either:

1. Copy exact URLs from the Quick Reference table below, OR
2. Run

   x402.discover_api_endpoints(url="https://enrichx402.com")

   to get the correct paths

Guessing paths will fail with 405 errors (wrong path) or 404 errors (missing

/api/

prefix).

Setup

Quick Reference

https://enrichx402.com/api/exa/search

https://enrichx402.com/api/exa/find-similar

https://enrichx402.com/api/exa/contents

https://enrichx402.com/api/exa/answer

https://enrichx402.com/api/firecrawl/scrape

https://enrichx402.com/api/firecrawl/search

When to Use What

Exa Neural Search

x402.fetch(
  url="https://enrichx402.com/api/exa/search",
  method="POST",
  body={
    "query": "startups building AI agents for customer support",
    "numResults": 10,
    "type": "neural"
  }
)

• query

  - Search query (required)

• numResults

  - Number of results (default: 10, max: 25)

• type

  - "neural" (semantic) or "keyword" (traditional)

• includeDomains

  - Only search these domains

• excludeDomains

  - Skip these domains

• startPublishedDate

  /

  endPublishedDate

  - Date range filter

Find Similar Pages

x402.fetch(
  url="https://enrichx402.com/api/exa/find-similar",
  method="POST",
  body={
    "url": "https://example.com/article-i-like",
    "numResults": 10
  }
)

• Finding competitor products
• Discovering related content
• Expanding research sources

Extract Text Content

x402.fetch(
  url="https://enrichx402.com/api/exa/contents",
  method="POST",
  body={
    "urls": [
      "https://example.com/article1",
      "https://example.com/article2"
    ]
  }
)

• urls

  - Array of URLs to extract

• text

  - Include full text (default: true)

• highlights

  - Include key highlights

Direct Answers

x402.fetch(
  url="https://enrichx402.com/api/exa/answer",
  method="POST",
  body={
    "query": "What is the population of Tokyo?"
  }
)

• Factual questions
• Quick lookups
• Verification of claims

Firecrawl Scrape

x402.fetch(
  url="https://enrichx402.com/api/firecrawl/scrape",
  method="POST",
  body={
    "url": "https://example.com/page-to-scrape"
  }
)

• url

  - Page to scrape (required)

• formats

  - Output formats: ["markdown", "html", "links"]

• onlyMainContent

  - Skip nav/footer/ads (default: true)

• waitFor

  - Wait ms for JS to render

• Handles JavaScript-rendered content
• Bypasses common blocking
• Extracts main content only
• LLM-optimized markdown output

Firecrawl Search

x402.fetch(
  url="https://enrichx402.com/api/firecrawl/search",
  method="POST",
  body={
    "query": "best practices for react server components",
    "limit": 5
  }
)

• query

  - Search query (required)

• limit

  - Number of results (default: 5)

• scrapeOptions

  - Options passed to scraper

Workflows

Deep Research

1. (Optional) Check balance:

   x402.get_wallet_info

2. Discover endpoints (required before first fetch):

   x402.discover_api_endpoints(url="https://enrichx402.com")

3. Search broadly with Exa
4. Find related sources with find-similar
5. Extract content from top sources
6. Synthesize findings

x402.fetch(
  url="https://enrichx402.com/api/exa/search",
  method="POST",
  body={"query": "AI agents in healthcare 2024", "numResults": 15}
)

x402.fetch(
  url="https://enrichx402.com/api/exa/find-similar",
  method="POST",
  body={"url": "https://best-article-found.com"}
)

x402.fetch(
  url="https://enrichx402.com/api/exa/contents",
  method="POST",
  body={"urls": ["url1", "url2", "url3"]}
)

Blocked Site Scraping

• Try WebFetch first (free)
• If blocked/empty, use Firecrawl with

  waitFor

  for JS-heavy sites

x402.fetch(
  url="https://enrichx402.com/api/firecrawl/scrape",
  method="POST",
  body={"url": "https://blocked-site.com/article", "waitFor": 3000}
)

Cost Optimization

• Use Exa contents ($0.002) when you already have URLs
• Use WebSearch/WebFetch first (free) and fall back to x402 endpoints
• Batch URL extraction - pass multiple URLs to Exa contents
• Limit results - request only as many as needed

Parallel Calls

# These don't depend on each other
x402.fetch(url=".../exa/search", body={"query": "topic A"})
x402.fetch(url=".../exa/search", body={"query": "topic B"})