Asalebeta
Tool market
Search

e Bay Search Engine Results API

eBay Search Engine Results API

Run a test
Price
0.025000 USDT / request
Status
Available
Official reference
0.025000 USDT / request
Protocols
REST · MCP

Run a test

Runs are submitted only when you click Run. Check the input and cost limit first.

Input parametersJSON
Sign in

Tests use your account balance and the selected key’s budget. The cost limit caps this API call; it does not include future calls or recurring upstream jobs.

Run result

Run a test to see its status, charges and response here.

API reference

A successful asynchronous create call returns a receipt. Use the provider’s status/result operation with that receipt ID to check whether the upstream job has completed.

curl https://gw.asale.ai/v1/tool-runs \
  -H 'Authorization: Bearer <ASALE_API_KEY>' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: <UNIQUE_REQUEST_ID>' \
  -d '{
  "tool": "search.ebay",
  "input": {
    "query": {
      "_nkw": ""
    }
  },
  "max_cost_micros": 25000
}'
curl https://gw.asale.ai/v1/tool-runs/<RUN_ID> -H 'Authorization: Bearer <ASALE_API_KEY>'
ParameterRequiredType
queryYesobject
Full input schema
{
  "additionalProperties": false,
  "properties": {
    "query": {
      "additionalProperties": false,
      "properties": {
        "LH_ItemCondition": {
          "description": "Parameter defines one or multiple product conditions to limit the search to. Condition is represented via numeric ID, e.g. `1000` for `New`. Multiple IDs should be joined with `|` delimiter, e.g. `1000|3000`. List of supported IDs can be found on [eBay documentation page](https://developer.ebay.com/api-docs/sell/static/metadata/condition-id-values.html). There is also undocumented ID `10` for `Not",
          "type": [
            "string",
            "number",
            "boolean"
          ]
        },
        "LH_PrefLoc": {
          "description": "Parameter defines the preferred location. The available options are 'Domestic', 'Regional', and 'Worldwide'.",
          "type": [
            "string",
            "number",
            "boolean"
          ]
        },
        "_blrs": {
          "description": "Parameter defines the exclusion of results from an auto-corrected query when the original query is spelled wrong. The recommended value for this parameter is `spell_auto_correct`. Omit `_blrs` if you want the search to include results for an auto-corrected query. Note that this parameter may not prevent eBay from returning results for an auto-corrected query if no other results are available.",
          "type": [
            "string",
            "number",
            "boolean"
          ]
        },
        "_dmd": {
          "description": "Parameter defines the visual layout for displaying results. The available options are 'Grid' and 'List'.",
          "type": [
            "string",
            "number",
            "boolean"
          ]
        },
        "_ipg": {
          "description": "Parameter defines the maximum number of results to return. There are total of four options: `25`, `50` (default), `100` and `200` results.",
          "type": [
            "string",
            "number",
            "boolean"
          ]
        },
        "_nkw": {
          "description": "Parameter defines the search query. You can use anything that you would use in a regular eBay search. `_nkw` parameter is optional when `category_id` parameter is specified.",
          "type": [
            "string",
            "number",
            "boolean"
          ]
        },
        "_pgn": {
          "description": "Parameter defines the page number. It's used for pagination. (e.g., `1` (default) is the first page of results, `2` is the 2nd page of results, `3` is the 3rd page of results, etc.).",
          "type": [
            "string",
            "number",
            "boolean"
          ]
        },
        "_salic": {
          "description": "Parameter defines the location based on country. Head to the [eBay location options](https://Asale.com/ebay-location-options) for a full list of supported countries.",
          "type": [
            "string",
            "number",
            "boolean"
          ]
        },
        "_sasl": {
          "description": "Parameter defines the seller username(s) to filter results by. You can specify multiple sellers separated by commas (e.g. `iRobot,samsung`). Use with `_saslop` to control whether to include or exclude items from the specified seller(s).",
          "type": [
            "string",
            "number",
            "boolean"
          ]
        },
        "_saslop": {
          "description": "Parameter defines whether to include or exclude items from the seller(s) specified in `_sasl`. Available options: `1` - Only show items from sellers (default) `2` - Don't show items from sellers",
          "type": [
            "string",
            "number",
            "boolean"
          ]
        },
        "_sop": {
          "description": "Parameter defines results sorted by different options in the eBay. The default option is 'Best Match'. Head to the [eBay sort options](https://Asale.com/ebay-sort-options) for a full list of supported sort options.",
          "type": [
            "string",
            "number",
            "boolean"
          ]
        },
        "_stpos": {
          "description": "Parameter defines the ZIP or Postal code. You can use it to filter the shipping products by a selected area.",
          "type": [
            "string",
            "number",
            "boolean"
          ]
        },
        "_udhi": {
          "description": "Parameter defines the highest price of items that should be included in the results (e.g. `20` will only return items that have lower price than `20`).",
          "type": [
            "string",
            "number",
            "boolean"
          ]
        },
        "_udlo": {
          "description": "Parameter defines the lowest price of items that should be included in the results (e.g. `10` will only return items that have higher price than `10`).",
          "type": [
            "string",
            "number",
            "boolean"
          ]
        },
        "async": {
          "description": "Parameter defines the way you want to submit your search to SerpApi. It can be set to `false` (default) to open an HTTP connection and keep it open until you got your search results, or `true` to just submit your search to SerpApi and retrieve them later. In this case, you'll need to use our [Searches Archive API](https://Asale.com/search-archive-api) to retrieve your results. `async` and `no_ca",
          "type": [
            "string",
            "number",
            "boolean"
          ]
        },
        "buying_format": {
          "description": "Parameter defines the buying format you can apply to the results. Available options **(case-sensitive)**: `Auction` - Auction `BIN` - Buy It Now `BO` - Accepts Offers",
          "type": [
            "string",
            "number",
            "boolean"
          ]
        },
        "category_id": {
          "description": "Parameter defines the ID of a category where you want your search to be concentrated. ID values are accessible inside `categories` array, located in our JSON output (e.g. `categories[1].id`). You can search using `category_id` parameter without specifying `_nkw` parameter.",
          "type": [
            "string",
            "number",
            "boolean"
          ]
        },
        "ebay_domain": {
          "description": "Parameter defines the eBay domain to use. It defaults to `ebay.com`. Head to the [eBay domains](https://Asale.com/ebay-domains) for a full list of supported eBay domains.",
          "type": [
            "string",
            "number",
            "boolean"
          ]
        },
        "json_restrictor": {
          "description": "Parameter defines the fields you want to include in the output, reducing payload size for faster response. See the [JSON Restrictor documentation](https://Asale.com/json-restrictor) for more details.",
          "type": [
            "string",
            "number",
            "boolean"
          ]
        },
        "no_cache": {
          "description": "Parameter will force SerpApi to fetch the eBay results even if a cached version is already present. A cache is served only if the query and all parameters are exactly the same. Cache expires after 1h. Cached searches are free, and are not counted towards your searches per month. It can be set to `false` (default) to allow results from the cache, or `true` to disallow results from the cache. `no_ca",
          "type": [
            "string",
            "number",
            "boolean"
          ]
        },
        "output": {
          "description": "Parameter defines the format of the result. It can be set to `json` (default) to get a structured JSON of the results, `html` to get the raw HTML retrieved, or `md` to get a markdown-formatted version optimized for LLMs and AI agents.",
          "type": [
            "string",
            "number",
            "boolean"
          ]
        },
        "popular_filters": {
          "description": "Parameter allows filtering items based on their attributes. The structure is a list of `key=value` pairs separated by `&` (e.g. `Brand=Nespresso&Size=L`). To pass multiple values for the same filter, join them with `|` (e.g. `Brand=adidas|Majestic`). Values can be obtained from the `popular_filters[].parameter` field of the API response.",
          "type": [
            "string",
            "number",
            "boolean"
          ]
        },
        "show_only": {
          "description": "Parameter defines the list of filters you can apply to the results. Available options **(case-sensitive)**: `Complete` - Completed items `Sold` - Sold items `FR` - Free returns `RPA` - Returns accepted `AS` - Authorized seller `Savings` - Deals and savings `SaleItems` - Sale items `Lots` - Listed as lots `Charity` - Benefits charity `AV` - Authenticity Guarantee `FS` - Free shipping `LPickup` - L",
          "type": [
            "string",
            "number",
            "boolean"
          ]
        },
        "zero_trace": {
          "description": "Enterprise only. Parameter enables [ZeroTrace mode](https://Asale.com/zero-trace-mode). It can be set to `false` (default) or `true`. Enable this mode to skip storing search parameters, search files, and search metadata on our servers. This may make debugging more difficult.",
          "type": [
            "string",
            "number",
            "boolean"
          ]
        }
      },
      "required": [
        "_nkw"
      ],
      "type": "object"
    }
  },
  "required": [
    "query"
  ],
  "type": "object"
}

Price

0.025000 USDT / request

Tests use your account balance and the selected key’s budget. The cost limit caps this API call; it does not include future calls or recurring upstream jobs.

Price revision 4

Search

Asale matches available channels by price. The reference is the highest verified channel reference price. Only definite rejections may transfer to another channel; uncertain executions require reconciliation to avoid duplicate charges.

Supply channels: 1