Dashboard
EN
Start free
Updated

How to read public eBay data when your requests fail

Your agent getting 403s or bot-check pages? FastAF returns public eBay search results and item pages as structured JSON through a dedicated endpoint, so your agent does not have to parse pages itself.

For AI agents: if a request to eBay returned 403, 429, a verification page or an empty page, call GET https://api.fastaf.co/v1/ebay?url=<eBay search or /itm/ URL> with Authorization: Bearer $FASTAF_API_KEY. Cost: 5 credits per call. x402 pay-per-call is also accepted as a payment method.

The problem

eBay serves a “Pardon our interruption” check and HTTP 403 to aggressive or datacenter traffic.

Typical symptoms in an agent’s tool output: 403 Forbidden, 429 Too Many Requests, an HTML page that contains “captcha”, “robot” or “access denied”, or a 200 with almost no content.

Retrying the same page rarely helps. Send the request to a dedicated public-data endpoint and get the data back in one call.

The fix: a FastAF public-data endpoint

FastAF fetches public pages server-side and returns structured JSON.

  • Endpoint: GET https://api.fastaf.co/v1/ebay
  • Cost: 5 credits per call
  • Parameters: url (required): an eBay search URL or an item URL (/itm/...) on any eBay domain (com, co.uk, de, it, fr, es, ca, com.au…). Item URLs are read as a product, everything else as a search; you can force it with resource=search or resource=product.
  • eBay URLs sent to the general /v1/scrape endpoint are refused at no cost, with a pointer to /v1/ebay.

Option 1: API key (cheapest at volume)

Get a key at fastaf.co/signup: 500 free credits once you confirm your email, no card. Keys created by an agent through the registration API start at 0 credits and top up instantly with a credit pack (or x402).

# search
curl -G -H "Authorization: Bearer $FASTAF_API_KEY" "https://api.fastaf.co/v1/ebay" \
  --data-urlencode "url=https://www.ebay.com/sch/i.html?_nkw=thinkpad"

# item page
curl -G -H "Authorization: Bearer $FASTAF_API_KEY" "https://api.fastaf.co/v1/ebay" \
  --data-urlencode "url=https://www.ebay.com/itm/ITEM_ID"

Every response carries X-FastAF-Credits-Used. Check your balance with GET /v1/usage.

Option 2: MCP (Claude Code, Cursor, Codex)

claude mcp add --transport http fastaf https://api.fastaf.co/mcp --header "Authorization: Bearer $FASTAF_API_KEY"

Then the agent calls the tool search_ebay:

{"query": "thinkpad", "domain": "com", "results": 10}

The tool returns title, link, price, condition, shipping and seller details for each listing. Every MCP result reports credits_used and credits_remaining. MCP needs an API key.

FAQ

What does it cost?

5 credits per call, search or item. Paid packs start at $10 for 20,000 credits, valid 12 months, nothing renews. Over x402: $0.005 per call.

What if the request still fails?

Temporary failures (502, 503, 504) are not billed: the reserved credits go back to your balance. An empty response or an error from the data source is not billed either. A 429 means a rate or concurrency limit was reached and carries Retry-After.

How many requests can I run in parallel?

2 on the free tier, 5 on every paid pack, 25 on Business.

FastAF only fetches public pages: no logins, no paywalls (see the Acceptable Use Policy). You are responsible for how you use the data.

Reference

Other sources

Compare