SerpApi Official icon

SerpApi Official

Get live Google Search data and more from SerpApi's official node

Actions72

Overview

The node performs live searches on eBay using SerpApi's official API. It allows users to query eBay listings with a variety of filters and parameters, returning structured search results. This node is useful for automating product research, price comparison, market analysis, or monitoring specific items on eBay.

Practical examples:

  • Searching for "coffee" related products in the United States eBay domain.
  • Filtering auction-only items within a certain price range.
  • Paginating through multiple pages of search results.
  • Restricting results by item condition or buying format.

Properties

Name Meaning
Search Query (_nkw) The main search query string used to find items on eBay. Optional if category ID is specified. Example: "coffee".
Domain (ebay_domain) The eBay regional domain to use for the search. Options include Australia, Austria, Canada, France, Germany, Hong Kong, Ireland, Italy, Malaysia, Netherlands, Philippines, Poland, Singapore, Spain, Switzerland, UK, USA, etc.
Location (_salic) Filters results by location based on country codes. Examples: United States, Canada, United Kingdom, Australia, Germany, etc.
Page Number (_pgn) Specifies which page of results to retrieve for pagination. Default is 1.
Number of Results (_ipg) Maximum number of results per page. Options: 25, 50, 100, 200 items per page. Default is 50.
Exclude Auto-corrected Results (_blrs) Boolean flag to exclude results from auto-corrected queries when the original query was misspelled. Default false.
Results filter (show_only) String to apply additional filters to the results list.
Buying Format (buying_format) Filter results by buying format. Options: Auction, Buy It Now, Accepts Offers. Default is Auction.
Price Low (_udlo) Minimum price filter; only items priced higher than this value are included.
Price High (_udhi) Maximum price filter; only items priced lower than this value are included.
Sorting (_sop) Defines sorting order of results. Options include Best Match (default), Time ending soonest, Newly listed, Price + Shipping lowest/highest first, Distance nearest first, Condition new/used first, etc. Default is Best Match.
View Option (_dmd) Visual layout for displaying results. Options: List or Grid. Default is List.
Category ID (category_id) Limits search to a specific eBay category by its ID.
ZIP Code (_stpos) Filters shipping products by ZIP or postal code area.
Condition (LH_ItemCondition) Filters results by product condition(s). Can specify one or multiple conditions.
Disable Caching (no_cache) Boolean to force fetching fresh results instead of cached ones. Cached results expire after 1 hour. Default false. Should not be used together with async.
Async (async) Boolean to perform search asynchronously. If true, results must be retrieved later via Search Archive API. Should not be used with no_cache or on accounts with Ludicrous Speed enabled. Default false.
ZeroTrace Mode (zero_trace) Enterprise-only boolean to skip storing search parameters and metadata on SerpApi servers for privacy. Default false.
Output (output) Defines output format. Options: JSON (structured data, default) or HTML (raw HTML response).
JSON Restrictor (json_restrictor) Allows restricting returned JSON fields to specific parts of the response, e.g., limiting to certain fields or result slices.

Output

The node outputs a JSON object containing the search results from eBay as returned by SerpApi. This includes detailed information about each listing such as title, price, condition, seller info, shipping details, and more depending on the query parameters.

If the output property is set to "html", the raw HTML content of the eBay search results page is returned instead.

No binary data output is involved.

Dependencies

  • Requires an active SerpApi account with a valid API key credential configured in n8n.
  • Internet access to call SerpApi endpoints.
  • No other external dependencies.

Troubleshooting

  • Common issues:

    • Missing or invalid API key credential will cause authentication errors.
    • Using incompatible combinations of parameters like no_cache and async simultaneously will cause request failures.
    • Specifying invalid category IDs or location codes may return empty results.
    • Pagination beyond available pages returns empty results.

  • Error messages:

    • Authentication errors indicate missing or incorrect API key setup.
    • Parameter validation errors suggest invalid or unsupported parameter values.
    • Rate limit errors occur if exceeding SerpApi usage limits; consider upgrading plan or reducing request frequency.

  • Resolutions:

    • Verify API key credential configuration.
    • Avoid conflicting parameters (no_cache and async).
    • Check parameter values against allowed options.
    • Implement error handling and retries for rate limits.

Links and References

Discussion