eBay sold listings API for agents
Understand eBay search URLs, sold filters and the limits of listing data.
Can FastAF guarantee sold transaction data?
No. The API accepts resource=search and an eBay search URL, but its documented output is listing data, not a verified transaction ledger. Sold/completed filters in a URL need validation on real results before relying on them.
What should you validate?
Check returned fields before using them in an agent decision. Missing fields are not evidence of zero values; preserve provenance and use bounded retries.
How do you make a real request?
This example calls eBay API using its documented input. Save the API key from the signup email, confirm your email and set FASTAF_API_KEY in your server environment.
curl --fail-with-body -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'# pip install fastaf-sdk
import os
from fastaf import FastAF
with FastAF(os.environ["FASTAF_API_KEY"]) as client:
data = client.request("ebay", {"resource":"search","url":"https://www.ebay.com/sch/i.html?_nkw=mechanical+keyboard"})
print(data)eBay search JSON. search_results contains listing title, itemId, condition, price, extracted_price, shipping and link when available. Item lookups return product_results instead.
The example costs 5 credits after the trial. Alternatively, this endpoint costs $0.005 per successful x402 call at the default configuration; FastAF x402 calls start at $0.003. These are separate billing modes.
For x402, request the same parameters under /x402/v1/ebay without an API key, validate the live PAYMENT-REQUIRED challenge, then sign and retry with a payment-aware client. A bare curl request returns HTTP 402 and does not pay; unsupported higher-cost options require API-key billing.
Frequently asked questions
Is a listing price a confirmed sale price?
No. Displayed listing prices do not prove the final amount paid, including accepted offers, shipping or taxes.
What does the endpoint return?
Search returns listing titles, prices, conditions and links when available, without a guaranteed sold-status field.
How much does the example cost?
The API-key example uses 5 credits per successful call after the trial. This endpoint has a default x402 price of $0.005 per successful call in USDC on Base; the live payment challenge is authoritative.
Does the SDK automatically pay an HTTP 402?
No. The API-key SDK does not sign wallet payments; x402 requires an explicitly configured payment-aware client and a funded wallet.