eBay API

The TrueScrape eBay API exposes 2 public endpoints covering eBay listing details and Search eBay listings. Every call is a GET against public, logged-out pages and returns the same unified schema as every other platform here. Calls cost 1 credit each. A cache hit is free, and a failed or empty response is never charged.

Endpoints

Reference

curl "$API/v1/ebay/product?cache_max_age=7d" \
  -H "x-api-key: $KEY"

const query = new URLSearchParams({
  cache_max_age: '7d',
});

const response = await fetch(`${API}/v1/ebay/product?${query}`, {
  headers: { 'x-api-key': KEY },
});

const body = await response.json();
if (!body.success) throw new Error(body.error.code);

// 1 credit, 0 on a cache hit
console.log(body.data, body.meta.creditsCharged);

import os, httpx

r = httpx.get(
    f"{os.environ['API']}/v1/ebay/product",
    params={
        "cache_max_age": "7d",
    },
    headers={"x-api-key": os.environ["KEY"]},
    timeout=30,
)

body = r.json()
if not body["success"]:
    raise RuntimeError(body["error"]["code"])

print(body["data"], body["meta"]["creditsCharged"])

curl "$API/v1/ebay/search?query=ai%20agents&cache_max_age=7d" \
  -H "x-api-key: $KEY"

const query = new URLSearchParams({
  query: 'ai agents',
  cache_max_age: '7d',
});

const response = await fetch(`${API}/v1/ebay/search?${query}`, {
  headers: { 'x-api-key': KEY },
});

const body = await response.json();
if (!body.success) throw new Error(body.error.code);

// 1 credit, 0 on a cache hit
console.log(body.data, body.meta.creditsCharged);

import os, httpx

r = httpx.get(
    f"{os.environ['API']}/v1/ebay/search",
    params={
        "query": "ai agents",
        "cache_max_age": "7d",
    },
    headers={"x-api-key": os.environ["KEY"]},
    timeout=30,
)

body = r.json()
if not body["success"]:
    raise RuntimeError(body["error"]["code"])

print(body["data"], body["meta"]["creditsCharged"])

Questions

How much does the eBay API cost?

Calls cost 1 credit each. Every endpoint is cacheable, and a cache hit costs nothing. A failed request and an empty result are both free, on every endpoint.

Does the eBay API need a login or cookies?

No. Every endpoint reads public, logged-out pages only — no account, no cookies, no session. An API key identifies your own TrueScrape account and nothing else.

Can I fetch many eBay targets in one request?

Yes. 2 of 2 are batchable: one POST to /v1/jobs/batch takes many targets and returns a job id to poll.

Can I watch eBay endpoints for changes?

Yes, 1 of 2. A subscription polls on your schedule and fires your webhook only when the content changed; the rest carry x-subscribable: false in the spec.