What format is the data returned in?

Responses are JSON. Each one contains the extracted data plus a _metadata block with the request ID and execution time.

What are the rate limits for the eBay Search API?

Up to 60 requests per minute, 1,000 per hour and 10,000 per day. Contact us if you need higher limits.

Can I run long requests in the background?

Yes. Add ?async=true to receive a job_id immediately, then poll /api/v1/jobs/ / until the status is COMPLETED.

Do I need to manage proxies or browsers?

No. DataGuru runs the infrastructure, proxies and retries. You only send an HTTP request with your API key.

E-Commerce API · Live

eBay Search API

Scrape eBay search results including listings, prices, sellers, filters, categories, and pagination.

No credit card required · Pay only for what you use

Price: $0.02 / req
Rate limit: 60 req/min
Output: Structured JSON
Modes: Sync & async

POSThttps://api.dataguru.cc/api/v1/ebay/search

curl -X POST "https://api.dataguru.cc/api/v1/ebay/search" \
  -H "Authorization: Api-Key YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"location": "US", "query": "example"}'

Response · 200 OK

{
  "search_metadata": {
    "status": "Success",
    "ebay_url": "https://example.com/..."
  },
  "search_information": {
    "total_results": 0,
    "total_results_text": "string",
    "query_displayed": "string"
  },
  "search_results": [
    {
      "position": 0,
      "itemId": "1234567890",
      "title": "string",
      "subtitle": "string",
      "is_new_listing": false,
      "seller": {
        "name": "string",
        "feedback": "string",
        "extracted_feedback": 0,
        "positive_feedback_percent": "string"
      },
      "condition": "string",
      "is_sponsored": false,
      "rating": "string",
      "reviews": "string",
      "reviews_link": "https://example.com/...",
      "buying_format": "string",
      "is_best_offer": false,
      "price": "string",
      "extracted_price": 0.0,
      "extracted_price_max": 0.0,
      "original_price": "string",
      "extracted_original_price": 0.0,
      "discount": "string",
      "link": "https://example.com/...",
      "items_sold": "string",
      "extracted_items_sold": 0,
      "watchers": "string",
      "extracted_watchers": 0,
      "bids": {
        "count": 0,
        "time_left": "string"
      },
      "promotion": "string",
      "stock_status": "string",
      "location": "string",
      "epid": "1234567890",
      "extensions": [
        "string"
      ],
      "shipping": "string",
      "extracted_shipping": 0.0,
      "delivery_days": "string",
      "is_free_return": false,
      "sold_date": "2026-01-01T12:00:00Z",
      "thumbnail": "https://example.com/...",
      "shipping_to": "string",
      "product_api_link": "https://example.com/..."
    }
  ],
  "popular_filters": [
    {
      "name": "string",
      "parameter": "string",
      "link": "https://example.com/..."
    }
  ],
  "categories": [
    {
      "name": "string",
      "id": 0,
      "link": "https://example.com/..."
    }
  ],
  "related_searches": [
    {
      "query": "string",
      "link": "https://example.com/..."
    }
  ],
  "inline_results": [
    {
      "title": "string",
      "items": [
        {
          "title": "string",
          "price": "string",
          "extracted_price": 0.0,
          "link": "https://example.com/..."
        }
      ]
    }
  ],
  "pagination": {
    "current": 0,
    "next": "https://example.com/...",
    "other_pages": {}
  },
  "_metadata": {
    "request_id": "3f6c1a2e-8b4d-4c1e-9a7f-2d5e6b7c8d9e",
    "execution_time_ms": 842,
    "endpoint": "eBay Search",
    "mode": "live",
    "format": "json",
    "timestamp": "2026-01-01T12:00:00+00:00"
  }
}

Data

eBay Search API response (structured JSON)

Every response follows the same schema, so you can map it once and rely on it.

Response fields

search_metadatasearch_informationsearch_resultspopular_filterscategoriesrelated_searchesinline_resultspagination

Request parameters

Name

Features

eBay Search API features that make scraping easy

No proxies or blocks to manage

DataGuru handles proxies, retries and anti-bot measures for you. You just send a request.

Clean, structured JSON

Every response uses the same 8 fields, so your parser never breaks.

One simple request

Send query and get results back. No browser automation or HTML parsing on your side.

Use cases

What you can build with the eBay Search API

Competitor price monitoring

Track competitor prices and offers over time and react before you lose the sale.

Product catalog enrichment

Fill gaps in your catalog with titles, images, specifications and ratings.

Assortment & inventory analysis

See which products competitors list, stock and promote across categories.

Who it's for

Built for teams of every size and background

Pricing analysts
Marketplace sellers
E-commerce brands
Repricing tools
Brand protection teams
Market researchers
Data engineers
Retail analytics startups

Get started

Start using the eBay Search API in minutes

1
Create a free account
Sign up in seconds and get $1.00 of free balance to test with.
2
Copy your API key
Generate a key in the Developer Portal and send it in the Authorization header.
3
Send a request
Call POST /api/v1/ebay/search with your parameters.

Pricing

Transparent & simple pricing

No subscription, no monthly minimum. Add funds to your balance and pay only for the requests you make.

Pay as you go

eBay Search

$0.02 / req

$1.00 free balance on sign-up
60 requests per minute
10,000 requests per day
Sync and async requests

FAQ

Frequently asked questions

The eBay Search API costs $0.02 per successful request, deducted from your prepaid balance. There is no subscription or monthly minimum. New accounts get $1.00 of free balance to try it.

More APIs

Other APIs you might need

E-Commerce

Try the eBay Search API for free!

Create an account and get $1.00 of free balance to test it. No credit card required.

eBay Search API

eBay Search API response (structured JSON)

Response fields

Request parameters

eBay Search API features that make scraping easy

No proxies or blocks to manage

Clean, structured JSON

One simple request

What you can build with the eBay Search API

Competitor price monitoring

Product catalog enrichment

Assortment & inventory analysis

Built for teams of every size and background

Start using the eBay Search API in minutes

Create a free account

Copy your API key

Send a request

Transparent & simple pricing

Frequently asked questions

Other APIs you might need

Amazon Product Search

Amazon Keyword Search

Amazon Best Sellers

Try the eBay Search API for free!

Sync or async

Built to scale

Pay only for what you use

Review & sentiment tracking

Market research

Repricing & MAP enforcement

Get structured JSON

Walmart Product Details

Walmart Search

eBay Product Details

location	string	Two-letter country code to localise results (e.g. US).
queryrequired	string	Search query or full eBay search URL (e.g. 'macbook pro' or 'https://www.ebay.com/sch/i.html?_nkw=macbook+pro').