eBay Related Searches API: Get Suggestion Strip Data as JSON
Enter a seed keyword and retrieve the related-search suggestions eBay displays around search results.
Each result can include the suggested query, its linked URL, and a thumbnail when eBay provides one. This narrow output is designed for keyword expansion rather than full listing extraction.
What you get back
Use this API when you need the suggestion strip alone. Supply a seed keyword, and the response isolates the related queries instead of mixing them with the main search-result listings. That distinction matters: use a broader eBay scraper for product listings, and use this endpoint when the research question is which adjacent terms buyers are being shown.
Output fields and a useful workflow
For each suggestion, expect three kinds of data: the suggested query text, the URL it links to, and a thumbnail when present. Treat the thumbnail as optional rather than guaranteed. A practical workflow is to start with one seed term, collect its suggestions, deduplicate the returned queries, then run the most promising terms again to build a second layer of long-tail candidates.
Research uses
Three research tasks fit this data well. First, explore related terms to uncover long-tail wording for SEO and category mapping. Second, compare suggestion patterns across seeds to spot emerging product trends. Third, inspect competitor-related suggestions to identify listings and market gaps worth investigating. Keep the purpose explicit in your dataset so suggestion data is not mistaken for sales volume or listing performance.
How it works
Create an account to obtain an API key, install the SDK for your stack, then send the eBay related-searches URL by POST or GET. The service renders the page, handles anti-bot measures, and can return rendered HTML or structured JSON through extraction rules. Advanced options include render_js for JavaScript, stealth_proxy for CAPTCHA handling, country_code for geo-targeting, and ai_extract_rules for natural-language extraction.
Supporting capabilities
Beyond the core suggestion strip, the surrounding tooling supports AI-powered extraction focused on targeted page sections, full-page screenshots, JavaScript scenarios, LLM-ready Markdown for query-pattern analysis, and no-code automation through n8n for building long-tail seed lists. Google search results can also surface eBay category and seller URLs to feed into fuller listing extraction.
Plan checklist
Before choosing a plan, check these items: the concurrency you need for batch keyword runs, whether JavaScript rendering is required, whether premium or stealth proxies are needed, whether geo-targeting matters, and whether screenshots or extraction rules are part of your workflow. Credits are described as valid for one month without rollover, and requests start at one credit each, with higher costs for optional rendering and proxy features. For current plan prices, credit allowances, and per-request costs, consult the pricing page or your account dashboard; treat any figure you see elsewhere as provisional until confirmed there.
Compliance, blocking, and scale
Proxy rotation and headless-browser rendering are described as ways to reduce IP-based blocking. Whether those measures are sufficient for your use case depends on the target site, request volume, and applicable terms, so evaluate them against your own deployment rather than assuming a fixed outcome. Before relying on compliance, scale, speed, or accuracy statements in production planning, confirm the applicable terms for your account and jurisdiction.
Frequently asked questions
How do I handle JavaScript when scraping eBay related searches?
Set render_js=true. The page runs in a headless browser, JavaScript executes server-side, and you receive the HTML after rendering.
Can I scrape eBay related searches from a specific country?
Yes. Set country_code to route the request through a residential IP in that country, which helps when results differ by location.
What's the rate limit for scraping eBay related searches?
Limits are based on plan concurrency rather than a per-target rate limit. If eBay throttles aggressive patterns, space requests out or use multiple sessions.
How do I get structured JSON from eBay related searches?
Use extract_rules with CSS selectors mapped to field names, or ai_extract_rules with a natural-language specification. The response is returned as parsed JSON.
Which programming languages can I use to scrape eBay related searches?
Any common stack works. SDKs are offered for Python, Node.js, Go, PHP, Ruby, and Java, and plain cURL also works.
How much does it cost to scrape eBay related searches?
Credit cost varies by option, including JavaScript rendering, premium proxies, and stealth proxies. For current per-request costs, plan prices, and any free-credit offer, check the pricing page or your account dashboard; treat figures quoted elsewhere as provisional until confirmed there.