SerpApi Official icon

SerpApi Official

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

Actions72

Overview

This node enables users to perform live eBay searches using SerpApi's official API. It is designed to retrieve real-time search results from eBay based on various customizable parameters, making it useful for applications such as market research, price comparison, product discovery, and inventory monitoring.

Typical use cases include:

  • Searching for products on eBay with specific keywords or within certain categories.
  • Filtering results by location, price range, buying format, and item condition.
  • Paginating through large result sets.
  • Customizing the output format (JSON or raw HTML).

For example, a user could search for "coffee" products available in the United States, sorted by price lowest first, and retrieve up to 50 items per page.

Properties

Name Meaning
Search Query (_nkw) The main search query string used on eBay. Optional if a category ID is specified. Example: "coffee".
Domain (ebay_domain) The eBay domain to search on. Options include Australia, Austria, Canada, France, Germany, Hong Kong, Ireland, Italy, Malaysia, Netherlands, Philippines, Poland, Singapore, Spain, Switzerland, UK, and US (default).
Additional Fields A collection of optional parameters to refine the search:
- Location (_salic) Filter results by country location. Many country options are available, e.g., United States, Canada, United Kingdom, Australia, etc.
- Page Number (_pgn) The page number for pagination. Default is 1.
- Number of Results (_ipg) Maximum number of results per page. Options: 25, 50 (default), 100, 200.
- Exclude Auto-corrected Results (_blrs) Whether to exclude results from auto-corrected queries when the original query was misspelled. Boolean, default false.
- Results filter (show_only) String to apply filters on the results list.
- Buying Format (buying_format) Filter by buying format: Auction (default), Buy It Now, Accepts Offers.
- Price Low (_udlo) Minimum price filter; only items priced higher than this value will be included.
- Price High (_udhi) Maximum price filter; only items priced lower than this value will be included.
- Sorting (_sop) Sort 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.
- View Option (_dmd) Visual layout of results: List (default) or Grid.
- Category ID (category_id) Restrict search to a specific eBay category by its ID.
- ZIP Code (_stpos) Filter shipping products by ZIP or postal code.
- Condition (LH_ItemCondition) Filter by product condition(s).
- Disable Caching (no_cache) Force fetching fresh results instead of cached ones. Boolean, default false. Cached results expire after 1 hour.
- Async (async) Perform search asynchronously. Boolean, default false. When true, results must be retrieved later via Search Archive API. Cannot be used with no_cache.
- ZeroTrace Mode (zero_trace) Enterprise-only mode to skip storing search data on SerpApi servers. Boolean, default false.
- Output (output) Defines output format: JSON (default) for structured data or html for raw HTML response.
- JSON Restrictor (json_restrictor) Restricts fields returned in the JSON response, e.g., limiting to certain fields or number of results.

Output

The node outputs a JSON object containing the search results from eBay according to the specified parameters. The structure typically includes metadata about the search and an array of product listings matching the query.

If the output format is set to html, the node returns the raw HTML content retrieved from the eBay search page.

No binary data output is indicated.

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 are required.

Troubleshooting

  • Common Issues:

    • Invalid or missing API key credential will cause authentication errors.
    • Using incompatible parameter combinations, such as setting both async and no_cache to true, may cause request failures.
    • Specifying invalid values for parameters like ebay_domain or category_id can lead to empty or error responses.
    • Rate limits imposed by SerpApi may restrict the number of requests; exceeding them will result in errors.

  • Error Messages:

    • Authentication errors indicate issues with the API key setup.
    • Parameter validation errors suggest incorrect or unsupported parameter values.
    • Network or timeout errors may occur if SerpApi service is unreachable.

  • Resolutions:

    • Verify API key configuration in n8n credentials.
    • Review parameter values against allowed options.
    • Avoid conflicting parameters (async and no_cache).
    • Check network connectivity and SerpApi service status.

Links and References

Discussion