Asalebeta
工具市場
搜尋

e Bay Search Engine Results API

eBay Search Engine Results API

呼叫測試
價格
0.025000 USDT / 請求
狀態
可呼叫
官方參考價
0.025000 USDT / 請求
呼叫方式
REST · MCP

呼叫測試

點擊執行後才會提交呼叫,請先檢查參數和費用上限。

輸入參數JSON
登入

測試會使用帳戶餘額,並受所選金鑰預算限制。費用上限僅約束本次 API 呼叫,不包含後續呼叫或上游週期任務。

執行結果

執行後,在這裡查看狀態、費用和回傳內容。

API 文件

非同步建立成功僅表示取得任務回執。需將回執 ID 傳給對應平台的狀態或結果介面,確認上游任務是否完成。

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>'
參數必填類型
queryobject
完整輸入規範
{
  "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"
}

價格

0.025000 USDT / 請求

測試會使用帳戶餘額,並受所選金鑰預算限制。費用上限僅約束本次 API 呼叫,不包含後續呼叫或上游週期任務。

價格版本 4

搜尋

Asale 依報價撮合同一能力的可用通道,優先選擇低價供給。參考價採各通道已核實參考價的最高值。只有明確未執行的拒絕才會轉移通道;結果不確定時進入對帳,避免重複收費。

供給通道: 1