eBay API

x402 pay per call

$0.005 per successful call, paid in USDC on Base. No account or API key required. The live PAYMENT-REQUIRED header quotes the authoritative price.

curl request

curl -i 'https://api.fastaf.co/x402/v1/ebay?resource=search&url=https%3A%2F%2Fwww.ebay.com%2Fsch%2Fi.html%3F_nkw%3Dmechanical%2Bkeyboard'

Example 402 payment challenge

Illustrative recipient address, not a payment destination. Request a fresh challenge, sign it with an x402 v2 client and retry the same URL with PAYMENT-SIGNATURE. The header is base64 JSON v2; the compatibility body uses v1 aliases on Base. Only successful results settle.

HTTP/1.1 402 Payment Required
Content-Type: application/json
PAYMENT-REQUIRED: eyJ4NDAyVmVyc2lvbiI6MiwicmVzb3VyY2UiOnsidXJsIjoiaHR0cHM6Ly9hcGkuZmFzdGFmLmNvL3g0MDIvdjEvZWJheT9yZXNvdXJjZT1zZWFyY2gmdXJsPWh0dHBzJTNBJTJGJTJGd3d3LmViYXkuY29tJTJGc2NoJTJGaS5odG1sJTNGX25rdyUzRG1lY2hhbmljYWwlMkJrZXlib2FyZCIsImRlc2NyaXB0aW9uIjoiRmFzdEFGIGVCYXkgTGlzdGluZ3MgJiBJdGVtIERhdGEiLCJtaW1lVHlwZSI6ImFwcGxpY2F0aW9uL2pzb24ifSwiYWNjZXB0cyI6W3sic2NoZW1lIjoiZXhhY3QiLCJuZXR3b3JrIjoiZWlwMTU1Ojg0NTMiLCJhbW91bnQiOiI1MDAwIiwiYXNzZXQiOiIweDgzMzU4OWZDRDZlRGI2RTA4ZjRjN0MzMkQ0ZjcxYjU0YmRBMDI5MTMiLCJwYXlUbyI6IjB4MTExMTExMTExMTExMTExMTExMTExMTExMTExMTExMTExMTExMTExMSIsIm1heFRpbWVvdXRTZWNvbmRzIjozMDAsImV4dHJhIjp7Im5hbWUiOiJVU0QgQ29pbiIsInZlcnNpb24iOiIyIn19XX0=

{
  "error": "payment_required",
  "x402Version": 2,
  "resource": {
    "url": "https://api.fastaf.co/x402/v1/ebay?resource=search&url=https%3A%2F%2Fwww.ebay.com%2Fsch%2Fi.html%3F_nkw%3Dmechanical%2Bkeyboard",
    "description": "FastAF eBay Listings & Item Data",
    "mimeType": "application/json"
  },
  "accepts": [
    {
      "scheme": "exact",
      "network": "eip155:8453",
      "amount": "5000",
      "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
      "payTo": "0x1111111111111111111111111111111111111111",
      "maxTimeoutSeconds": 300,
      "extra": {
        "name": "USD Coin",
        "version": "2"
      }
    }
  ]
}

Decoded PAYMENT-REQUIRED header

{
  "x402Version": 2,
  "resource": {
    "url": "https://api.fastaf.co/x402/v1/ebay?resource=search&url=https%3A%2F%2Fwww.ebay.com%2Fsch%2Fi.html%3F_nkw%3Dmechanical%2Bkeyboard",
    "description": "FastAF eBay Listings & Item Data",
    "mimeType": "application/json"
  },
  "accepts": [
    {
      "scheme": "exact",
      "network": "eip155:8453",
      "amount": "5000",
      "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
      "payTo": "0x1111111111111111111111111111111111111111",
      "maxTimeoutSeconds": 300,
      "extra": {
        "name": "USD Coin",
        "version": "2"
      }
    }
  ]
}

JSON discovery response example

eBay search JSON. search_results contains listing title, itemId, condition, price, extracted_price, shipping and link when available. Item lookups return product_results instead. This example is illustrative.

{
  "search_results": [
    {
      "position": 1,
      "itemId": "123456789012",
      "title": "Mechanical keyboard with brown switches",
      "condition": "Pre-owned",
      "price": "$45.00",
      "extracted_price": 45,
      "shipping": "Free shipping",
      "link": "https://www.ebay.com/itm/123456789012"
    }
  ]
}

Response with an API key

The same data over REST with a prepaid key. The JSON body is the example above; failed requests are not charged.

curl -H "Authorization: Bearer $FASTAF_API_KEY" 'https://api.fastaf.co/v1/ebay?resource=search&url=https%3A%2F%2Fwww.ebay.com%2Fsch%2Fi.html%3F_nkw%3Dmechanical%2Bkeyboard'

MCP tools

search_ebay MCP tool calls require an API key or OAuth; x402 payments apply to HTTP data calls.

Full endpoint reference for agents

Pricing

x402: $0.005 per successful call, USDC on Base, no account. API key: 5 credits per request from one-time credit packs, without expiry. Credit packs are shared by every endpoint and never renew.

Free: 500 credits every month after email verification, no card. See pricing. Alternatives: FastAF vs SerpApi, vs toll402, vs serp402, vs AgentBIT, vs Amazon PA-API.

Parameters

Response fields

• search_results

Passing these fields to an LLM? See token-aware scraping: only what your LLM needs.

Guides

• How to read public eBay data when your requests fail

  eBay showing "Pardon our interruption"? Get public search and item data as JSON for 5 credits. API key, MCP or x402 pay-per-call.

• Add FastAF to Claude Code, Codex and Cursor

  One remote MCP server, three clients: the claude, codex and Cursor mcp.json setup for https://api.fastaf.co/mcp, with the API key auth it really uses.

FAQ

Other APIs

• Amazon API

  Search, products, offers and bestsellers

• Google Shopping API

  Product prices and merchants

• Walmart API

  Walmart product search results

• Web Scraping API

  Public pages in selectable formats

All APIs → · Guides and benchmarks on the blog →