---
title: "Search eBay listings"
method: POST
path: "/ebay/search"
tags: ["eBay"]
---

# Search eBay listings

`POST /ebay/search`

## Request

- Base URL: `https://api.crawlora.net/api/v1`
- URL: `https://api.crawlora.net/api/v1/ebay/search`
- Auth: API key in header `x-api-key`

Searches eBay listings by keyword from a JSON body, with page, page size (60, 120 or 240) and a listing-status filter (`active`, `sold`, `completed` or `sold_completed`). Each result has the item id, title, link, image, price or price range, bid count, seller and rating, location, shipping information, and sold and watcher counts.

## Headers

- `x-api-key` string, required

## Request body

- EbaySearchOption
  - `keyword` string, required: keyword to search on Ebay
  - `limit` 60 | 120 | 240: Number of items per page
  - `listing_type` 'active' | 'sold' | 'completed' | 'sold_completed': Listing type to search
  - `page` integer: Page number

## Response `200`

OK

- EbaySearchResponseDoc
  - `code` integer: Code is the HTTP status code or a custom code used to indicate the result of the request @example 200
  - `data` EbaySearchResp
    - `has_more` boolean: Whether more results are available on later pages.
    - `page` integer: Page number returned.
    - `result` EbaySearchItem[]: Listings on this page.
      - `bid_count` integer: Number of bids on an auction listing.
      - `caption` string: Caption line shown on the search card.
      - `image` string: URL of the listing's thumbnail image.
      - `is_authenticity_guaranteed` boolean: Whether the listing carries eBay's Authenticity Guarantee.
      - `item_id` string: eBay item ID of the listing. Use it with the item endpoint.
      - `link` string: URL of the listing on eBay.
      - `location` string: Item location shown on the search card, such as `Canada`.
      - `logistic` string: Shipping information shown on the search card, such as `+$4.95 shipping`.
      - `offer_note` string: Purchase option label shown on the card, such as `Buy It Now`.
      - `price` number: Listing price as a number. Set only when the card shows a single price, not a range.
      - `price_from` number: $10 to $20
      - `price_to` number: Upper end of the price when the card shows a price range.
      - `rating` number: Average product star rating.
      - `rating_num` integer: Number of product ratings.
      - `seller` string: Seller name with feedback count and positive percentage, as shown on the card, such as `soonerfan1949 (998) 100%`.
      - `sold_count` integer: Number of units sold, as shown on the card.
      - `sub_title` string: Subtitle line shown on the card, such as `Pre-Owned`.
      - `title` string: Listing title as shown on the search card.
      - `watcher_count` integer: Number of users watching the listing.
    - `total` integer: Total number of results eBay reports for the search.
  - `msg` unknown

## Other responses

- `400`: Bad Request
- `429`: Too Many Requests
- `500`: Internal Server Error
- `503`: Service Unavailable

---

[API](https://skmtc.dev/crawlora/apis/crawlora-api.md) · [All operations](https://skmtc.dev/crawlora/apis/crawlora-api/llms.txt) · [OpenAPI document](https://skmtc.dev/crawlora/apis/crawlora-api/revisions/028417aa35bb?raw)