eBay Image Search API for Visual Product Lookup
Point the API at an image URL and it runs that image against eBay's visual search index, returning ranked matching listings.
Each result carries the title, current price, condition, seller, item ID, image URL and listing URL — enough to power resale-arbitrage checks, counterfeit detection and visual cataloguing without maintaining your own headless browser fleet or proxy pool.
What the API does with your image
You supply an image URL, optionally with filters such as price range, condition and location. The service submits the image to eBay's visual search, walks through the matches, and returns a ranked listing array with pricing and seller detail. JavaScript rendering, residential proxy rotation and geo-targeting are handled for you, so the response is post-render HTML or structured data ready to parse rather than a blocked page.
The seven fields in every listing
Every image-search response returns the same listing shape. Use it as a field map when you design your parser:
- title — the listing headline, useful for matching the visual result to a product name.
- current price — the live asking price at the time of the request.
- condition — new, used or other state, which matters for resale and counterfeit checks.
- seller — the account behind the listing, for seller-profile analysis.
- item ID — the stable eBay identifier for the listing.
- image URL — the listing's own image, handy for visual cataloguing.
- listing URL — the direct link back to the eBay page.
Common jobs this fits
Three patterns recur. First, extracting product images so you can compare visual data across competitors and spot market trends. Second, gathering seller profiles to map relationships and identify potential partners. Third, analyzing image metadata to surface emerging trends and sharpen positioning. Each of these maps directly to the same image-search call — the difference is what you do with the returned fields.
From sign-up to first result
Start by creating an account, which gives you an API key and a starter credit allowance to test with. Choose a client library that matches your stack — Python, Node, Go, PHP or Ruby — so a single function call covers each eBay Image Search request. Then issue a GET request carrying your API key and the eBay Image Search URL on eBay.com. JavaScript rendering and residential proxy rotation happen on the service side, and you receive rendered HTML that is ready to parse. For harder pages, add the advanced parameters: render_js to execute JavaScript, stealth_proxy to get past CAPTCHA challenges, country_code to target a geography, and ai_extract_rules to pull data using natural-language instructions.
Worked example: one image, filtered results
Suppose you have a photo of a used camera lens and want to know what the same model is fetching on eBay right now. You send the image URL with a price range and a condition filter set to used. The API submits the image to eBay's visual search, paginates through matches, and returns a ranked array. You then read the current price and condition fields to compare against your own cost, and the seller field to see whether the same accounts keep appearing. The item ID and listing URL let you open any result directly for a manual check.
When a request fails, which control to reach for
A blocked or empty response usually has one of three causes, and each maps to a different control. If the target is rejecting your traffic at the IP level, enable stealth_proxy on the request so it routes through a stealthier proxy. If the page content is built by JavaScript and your response looks empty or pre-render, pass render_js=true so the page runs in a real headless browser and you get post-render HTML. If the content varies by country — for example, listings shown differ by region — pass country_code to route through a residential IP in that country. Separating these three cases avoids the common mistake of adding every control at once and inflating credit cost.
Credits, concurrency and plan choice
Billing starts at one credit per request. Requests that enable JavaScript rendering and requests that enable premium proxies each carry their own additional credit cost, and credits are subject to an expiry window — check the current pricing page for the exact multipliers and validity period before you size a plan. Concurrency means how many requests you can have in flight simultaneously; it is assigned per plan, not per target site. The plan table below lays out the full ladder from Hobby through Enterprise 120, and the figures and feature inclusions shown there are the authoritative contract for what each tier provides.
Setup and language support
Code samples are provided for Python, Node.js, Ruby, PHP, Go and cURL, and the dashboard includes a request builder so you can test a call without writing code. The same builder generates a snippet in any of those languages, which is useful when you want to confirm a parameter combination before wiring it into a pipeline.
| Plan | Monthly price | API credits | Concurrent requests | JS rendering | Rotating & premium proxies | Geotargeting | Screenshots & extraction rules | Priority email support | Dedicated account manager | Team management |
|---|---|---|---|---|---|---|---|---|---|---|
| Hobby | $19 /mo | 75,000 | 25 | Included | Included | Included | Included | Not included | Not included | Not included |
| Freelance | $49 /mo | 250,000 | 50 | Included | Included | Included | Included | Not included | Not included | Not included |
| Startup (Recommended) | $99 /mo | 1,000,000 | 100 | Included | Included | Included | Included | Not included | Not included | Not included |
| Business | $249 /mo | 3,000,000 | 200 | Included | Included | Included | Included | Included | Included | Included |
| Business + | $599 /mo | 8,000,000 | 400 | Included | Included | Included | Included | Included | Included | Included |
| Enterprise 14 | $999 /mo | 14,000,000 | 500 | Included | Included | Included | Included | Included | Included | Included |
| Enterprise 24 | $1,599 /mo | 24,000,000 | 600 | Included | Included | Included | Included | Included | Included | Included |
| Enterprise 41 (Recommended) | $2,399 /mo | 41,000,000 | 700 | Included | Included | Included | Included | Included | Included | Included |
| Enterprise 69 | $3,599 /mo | 69,000,000 | 800 | Included | Included | Included | Included | Included | Included | Included |
| Enterprise 120 | $5,799 /mo | 120,000,000 | 900 | Included | Included | Included | Included | Included | Included | Included |
Prices are shown per month and exclude VAT where applicable. Credits are valid for a limited period and do not roll over; requests start at 1 credit each, with additional credits charged for JavaScript rendering and for premium proxies. Geotargeting coverage varies by proxy type. Confirm the current figures, validity window and country coverage on the pricing page before committing to a tier.
Frequently asked questions
How do I make my first eBay image search call?
Create an account to get an API key and a starter credit allowance for testing, then send a GET request with the target eBay Image Search URL. The service renders the page, rotates proxies and returns the data.
What should I do if my requests are being blocked?
Residential proxies rotate and a real headless browser is used, so requests resemble normal traffic. If a target becomes aggressive, enable stealth_proxy on the request to route through a stealthier proxy.
Can I test a call without writing code?
Yes. The dashboard request builder lets you paste a URL, set parameters and copy the generated snippet in Python, Node, Go, PHP, Ruby or cURL.
How is JavaScript handled on the target page?
Pass render_js=true on the request. The page runs in a real headless browser, the JS executes server-side, and you receive the post-render HTML.
Can I get results from a specific country?
Yes. Pass country_code on the request to route through a residential IP in that country. This matters when listings or content vary by geography.
Is there a rate limit per target?
Concurrency limits are set per plan rather than per target. If a target throttles aggressive patterns, space out requests or use multiple sessions.