# EBay search

Search eBay listings by keyword or category. Takes ebay domain, nkw, category id and more, all optional. Served by Litescrape.

Search eBay listings by keyword or category.

- Tool ID: `litescrape/ebay-search`
- Name in the catalog: eBay Search
- Provider: [Litescrape](/providers/litescrape.md)
- Capability: [E-commerce](/tools/ecommerce.md)
- Price: $0.00015 per call
- Authentication: an authorised Agentik workspace is required for execution, including zero-price tools.

## Pricing contract

The provider’s price, with no markup. Billed for measured usage.


```json
{
  "model": "per_call",
  "amountUsd": 0.00015
}
```

Pricing source: [https://litescrape.com/pricing](https://litescrape.com/pricing). $0.15 per 1,000 successful HTTP 200 requests; every native endpoint costs one call. Failed requests are not billed. Prepaid credits expire after six months..

Price verification date: 2026-11-03.

## Complete input schema


```json
{
  "additionalProperties": false,
  "properties": {
    "ebay_domain": {
      "default": "ebay.com",
      "description": "eBay marketplace hostname.",
      "enum": [
        "ebay.com",
        "ebay.co.uk",
        "ebay.ca",
        "ebay.com.au",
        "ebay.de",
        "ebay.fr",
        "ebay.it",
        "ebay.es",
        "ebay.at",
        "ebay.be",
        "ebay.ch",
        "ebay.ie",
        "ebay.nl",
        "ebay.com.hk",
        "ebay.com.my",
        "ebay.pl",
        "ebay.com.sg"
      ],
      "type": "string"
    },
    "_nkw": {
      "anyOf": [
        {
          "maxLength": 500,
          "minLength": 1,
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "Search keywords. Required unless category_id is supplied."
    },
    "category_id": {
      "anyOf": [
        {
          "maximum": 2147483647,
          "minimum": 1,
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "description": "eBay category ID."
    },
    "_pgn": {
      "default": 1,
      "description": "Result page, starting at 1.",
      "maximum": 2147483647,
      "minimum": 1,
      "type": "integer"
    },
    "_ipg": {
      "default": 50,
      "description": "Requested results per page. eBay may adjust the page size.",
      "enum": [
        25,
        50,
        100,
        200
      ],
      "type": "integer"
    },
    "_sop": {
      "default": 12,
      "description": "Sort: 12 best match, 1 ending soonest, 10 newly listed, 7 nearest, 15/16 total price ascending/descending, 2/3 item price ascending/descending, 18/19 condition new/used first. Availability depends on marketplace.",
      "enum": [
        1,
        2,
        3,
        7,
        10,
        12,
        15,
        16,
        18,
        19
      ],
      "type": "integer"
    },
    "_udlo": {
      "anyOf": [
        {
          "minimum": 0,
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "description": "Minimum item price."
    },
    "_udhi": {
      "anyOf": [
        {
          "minimum": 0,
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "description": "Maximum item price."
    },
    "buying_format": {
      "anyOf": [
        {
          "enum": [
            "Auction",
            "BIN",
            "BO"
          ],
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "Auction, Buy It Now (BIN), or accepts offers (BO)."
    },
    "LH_ItemCondition": {
      "anyOf": [
        {
          "pattern": "^[0-9]{1,4}(\\|[0-9]{1,4}){0,9}$",
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "Condition IDs joined with |, such as 1000|3000."
    },
    "_stpos": {
      "anyOf": [
        {
          "maxLength": 20,
          "minLength": 1,
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "Destination postal code used by eBay for shipping estimates."
    },
    "_salic": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "description": "eBay item-location country ID, e.g. 1 US, 2 Canada, 3 UK."
    },
    "_blrs": {
      "anyOf": [
        {
          "const": "spell_auto_correct",
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "Exclude automatic spelling corrections."
    },
    "show_only": {
      "anyOf": [
        {
          "maxLength": 100,
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "Comma-separated filters: FR, RPA, AS, Savings, SaleItems, Lots, Charity, AV, FS, LPickup."
    },
    "_sasl": {
      "anyOf": [
        {
          "maxLength": 1000,
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "Comma-separated eBay seller usernames."
    },
    "_saslop": {
      "default": 1,
      "description": "Include (1) or exclude (2) the sellers in _sasl.",
      "enum": [
        1,
        2
      ],
      "type": "integer"
    },
    "popular_filters": {
      "anyOf": [
        {
          "maxLength": 4000,
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "eBay aspect filters as key=value pairs joined with &, with multiple values joined by |. Percent-encoded names are accepted."
    },
    "_dmd": {
      "anyOf": [
        {
          "enum": [
            "Grid",
            "List"
          ],
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "Result layout."
    },
    "LH_PrefLoc": {
      "anyOf": [
        {
          "enum": [
            "Domestic",
            "Regional",
            "Worldwide"
          ],
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "Item location relative to the marketplace."
    }
  },
  "type": "object",
  "allOf": [
    {
      "anyOf": [
        {
          "required": [
            "_nkw"
          ],
          "properties": {
            "_nkw": {
              "not": {
                "enum": [
                  null,
                  ""
                ]
              }
            }
          }
        },
        {
          "required": [
            "category_id"
          ],
          "properties": {
            "category_id": {
              "not": {
                "enum": [
                  null,
                  ""
                ]
              }
            }
          }
        }
      ]
    }
  ]
}
```

## Published example

This is the provider tool’s published example. Replace example values with the user’s requested inputs, respecting the schema; do not execute an example merely to test a connection.


```json
{
  "tool_id": "litescrape/ebay-search",
  "input": {
    "_nkw": "lego star wars",
    "_ipg": 25
  }
}
```

## Execute and retrieve

Inspect again before execution, explain the price and obtain the required authority. Use MCP run_tool or POST /v1/run with this tool ID, valid input and an idempotency key. Save the returned run ID and follow the actual state. If Agentik answers that the tool is temporarily unavailable, do not retry it blindly; use discovery to propose an alternative.

A partial or uncertain result can still have consumed provider resources. Consult [billing](/docs/billing.md), [idempotency](/docs/idempotency.md) and [asynchronous results](/docs/async.md).

[Provider documentation](https://litescrape.com/docs/reference#ebay-search-parameters)

[REST inspection](https://api.agentik.cc/v1/tools/litescrape/ebay-search) · [OpenAPI](/openapi.json) · [Connection guide](/connect.md)

---

[HTML page](/providers/litescrape/ebay-search) · [Agent index](/llms.txt)