Ebay Search API

Api Details

Endpoint GET https://serpapi.abcproxy.com/search

Description Retrieve comprehensive user profile including basic info, account status and optional permission sets.

---

Request

HTTP Request

cURL

curl -X GET "https://serpapi.abcproxy.com/search" \
  -d "engine=ebay" \
  -d "_nkw=Coffee" \
  -d "no_cache=false" \
  -d "api_key=YOUR_API_KEY"

Python

import requests

params = {
    "engine": "ebay",
    "_nkw": "Coffee",
    "no_cache": "false",
    "api_key": "YOUR_API_KEY"
}
response = requests.get("https://serpapi.abcproxy.com/search", params=params)
print(response.json())

Node.js

const axios = require('axios');

const params = {
  engine: "ebay",
  _nkw: "Coffee",
  no_cache: "false",
  api_key: "YOUR_API_KEY"
};

axios.get("https://serpapi.abcproxy.com/search", { params })
  .then(response => console.log(response.data));

HTTP

GET /search?engine=ebay&q=Coffee&no_cache=false&api_key=YOUR_API_KEY HTTP/1.1
Host: serpapi.abcproxy.com

PHP

<?php
$client = new \GuzzleHttp\Client();
$response = $client->get('https://serpapi.abcproxy.com/search', [
    'query' => [
        'engine' => 'ebay',
        '_nkw' => 'Coffee',
        'no_cache' => 'false',
        'api_key' => 'YOUR_API_KEY'
    ]
]);
echo $response->getBody();

Golang

package main

import (
    "net/http"
    "io/ioutil"
    "log"
)

func main() {
    client := &http.Client{}
    req, _ := http.NewRequest("GET", "https://serpapi.abcproxy.com/search", nil)
    
    q := req.URL.Query()
    q.Add("engine", "ebay")
    q.Add("_nkw", "Coffee")
    q.Add("no_cache", "false")
    q.Add("api_key", "YOUR_API_KEY")
    req.URL.RawQuery = q.Encode()

    resp, _ := client.Do(req)
    body, _ := ioutil.ReadAll(resp.Body)
    log.Println(string(body))
}

C#

using System;
using System.Net.Http;

class Program
{
    static async Task Main()
    {
        var client = new HttpClient();
        var query = System.Web.HttpUtility.ParseQueryString(string.Empty);
        query["engine"] = "ebay";
        query["_nkw"] = "Coffee";
        query["no_cache"] = "false";
        query["api_key"] = "YOUR_API_KEY";
        
        var response = await client.GetAsync(
            $"https://serpapi.abcproxy.com/search?{query}"
        );
        Console.WriteLine(await response.Content.ReadAsStringAsync());
    }
}

Java

import java.net.*;
import java.io.*;

public class Main {
    public static void main(String[] args) throws Exception {
        String url = "https://serpapi.abcproxy.com/search" +
            "?engine=ebay" +
            "&_nkw=Coffee" +
            "&no_cache=false" +
            "&api_key=YOUR_API_KEY";
        
        HttpURLConnection conn = (HttpURLConnection) new URL(url).openConnection();
        conn.setRequestMethod("GET");
        
        BufferedReader in = new BufferedReader(
            new InputStreamReader(conn.getInputStream())
        );
        String response = in.lines().collect(Collectors.joining());
        System.out.println(response);
    }
}

---

API Parameters

Search Query

Name	Type	Required	Description	Example
_nkw	string	Yes	Parameter defines the search query. You can use anything that you would use in a regular Ebay search. _nkw parameter is optional when category_id parameter is specified.	123

Localization

Name	Type	Required	Description	Example
ebay_domain	string	No	Parameter defines the Ebay domain to use. It defaults to ebay.com. Head to the Ebay domains for a full list of supported Ebay domains.	us
_salic	string	No	Parameter defines the location based on country. Head to the Ebay location options for a full list of supported countries.	en

Pagination

Name	Type	Required	Description	Example
_pgn	string	No	Parameter defines the page number. It's used for pagination. (e.g., 1 (default) is the first page of results, 2 is the 2nd page of results, 3 is the 3rd page of results, etc.).	1
_ipg	string	No	Parameter defines the maximum number of results to return. There are total of four options: 25, 50 (default), 100 and 200 results.	50

Advanced Filters

Name	Type	Required	Description	Example
_blrs	string	No	Parameter defines the exclusion of results from an auto-corrected query when the original query is spelled wrong. The recommended value for this parameter is spell_auto_correct. Omit _blrs if you want the search to include results for an auto-corrected query. Note that this parameter may not prevent eBay from returning results for an auto-corrected query if no other results are available.	spell_auto_correct
show_only	string	No	Parameter defines the list of filters you can apply to the results. Available options (case-sensitive): Complete - Completed items Sold - Sold items FR - Free returns RPA - Returns accepted AS - Authorized seller Savings - Deals and savings SaleItems - Sale items Lots - Listed as lots Charity - Benefits charity AV - Authenticity Guarantee FS - Free shipping LPickup - Local pickup You can also combine multiple filter values by joining them with a comma (value + , + value; eg: Sold,FS).	-
buying_format	string	No	Parameter defines the buying format you can apply to the results. Available options (case-sensitive): Auction - Auction BIN - Buy It Now BO - Accepts Offers	-

Advanced Ebay Parameters

Name	Type	Required	Description	Example
_udlo	string	No	Parameter defines the lowest price of items that should be included in the results (e.g. 10 will only return items that have higher price than 10).	10
_udhi	string	No	Parameter defines the highest price of items that should be included in the results (e.g. 20 will only return items that have lower price than 20).	20
_sop	string	No	Parameter defines results sorted by different options in the Ebay. The default option is 'Best Match'. Head to the Ebay sort options for a full list of supported sort options.	-
_dmd	string	No	Parameter defines the visual layout for displaying results. The available options are 'Grid' and 'List'.	-
category_id	string	No	Parameter defines the ID of a category where you want your search to be concentrated. ID values are accessible inside categories array, located in our JSON output. You can search using category_id parameter without specifying _nkw parameter.	categories[1].id
_stpos	string	No	Parameter defines the ZIP or Postal code. You can use it to filter the shipping products by a selected area.	-
LH_ItemCondition	string	No	Parameter defines one or multiple product conditions to limit the search to. Condition is represented via numeric ID, e.g. 1000 for New. Multiple IDs should be joined with `	delimeter, e.g.1000

Serpapi Parameters

Name	Type	Required	Description	Example
engine	string	Yes	Set parameter to google_play to use the Google Play API engine.	google_play
no_cache	boolean	No	Parameter will force SerpApi to fetch the Google Play results even if a cached version is already present. A cache is served only if the query and all parameters are exactly the same. Cache expires after 1h. Cached searches are free, and are not counted towards your searches per month. It can be set to false (default) to allow results from the cache, or true to disallow results from the cache.	trueorfalse
api_key	string	Yes	Parameter defines the SerpApi private key to use.	-

---

Response

Success 200

Response Body

{
    "search_metadata": {
    "id": "55e12d9b-6dd4-4d4b-bb88-54e8cc6798da",
    "json_endpoint": "https://webserp.abcproxy.com/files/0935edaf41fa9b00/55e12d9b-6dd4-4d4b-bb88-54e8cc6798da.json",
    "created_at": "2025-04-02 16:37:45",
    "google_news_url": "https://www.ebay.com/sch/i.html?_nkw=Coffee",
    "raw_html_file": "https://webserp.abcproxy.com/files/0935edaf41fa9b00/55e12d9b-6dd4-4d4b-bb88-54e8cc6798da.html",
    "xray_html_file": "https://webserp.abcproxy.com/files/0935edaf41fa9b00/55e12d9b-6dd4-4d4b-bb88-54e8cc6798da.xray",
    "total_time_taken": "7.7340"
  },
  "search_parameters": {
    "engine": "ebay",
    "no_cache": true,
    "api_key": "YOUR_API_KEY",
    "_nkw": "Coffee"
  },
  "inline_results": [
    {
      "title": "Picked For You",
      "items": [
        {
          "title": "Keurig Decaf Coffee Variety Pack, Keurig K-Cup Pods, 96 CountOpens in a new window or tab",
          "link": "https://www.ebay.com/itm/314945798292?_skw=Coffee&itmmeta=01JQTTC9325881PMMMGG8R01T8&hash=item49543b8094:g:fZYAAOSwOhdlShvd&itmprp=enc%3AAQAKAAAA4FkggFvd1GGDu0w3yXCmi1c2MuHg0cS0xPKvVXwdBVRF9hQ9ASRDy4%2BSFIEbEEW8nhHwXamhTrVdMxpbJoCjz0YFW8IFF72kkW8%2BRkQhqWDLEBBe0ML9GP8rp3UkE4q4kcoddNekjXfwr2SN66TdFYjgASO5MW25XSgWucqq%2ByNUiloBKyg%2Fg%2FM%2FUdCfTHF2be2bcG7j%2BYyR5yCZby%2F03b4%2FtNqJQWeYTSoST4GrsnzpnSM0mOPebSjgo7h6lBdUngvCKbk4YfRpSbbvdDeTF5yAXoLpxL9%2BpmqSYlZ19%2FXB%7Ctkp%3ABFBM2JGx2r5l",
          "price": [
            {
              "raw": "$39.99"
            }
          ],
          "thumbnail": "https://i.ebayimg.com/images/g/fZYAAOSwOhdlShvd/s-l500.webp",
          "quantity_sold": "1,032 sold",
          "seller": [
            {
              "username": "keurig"
            }
          ]
        },
        {
          "title": "Starbucks Premium  Roast Ground Coffee - Medium Roast 12 bags 9LB Total (6/2025)Opens in a new window or tab",
          "link": "https://www.ebay.com/itm/146350144403?_skw=Coffee&itmmeta=01JQTTC932P024NEP32ZT3TBBP&hash=item221325fb93:g:5ccAAOSwyDZnlB5M&itmprp=enc%3AAQAKAAAA4FkggFvd1GGDu0w3yXCmi1eOGt%2FYhl0obgVpXzNWNdtqT6Ec7a8S9npEyGsTVgdjMoQhryr8141DGpxWbZFWyWJXGuWvxCAsQFlFx1%2FaMLQkxA0IAvkD%2B%2FRYXqVUWMKDUAAYaizbV%2FCha%2BSszA3x2eoesg5n2aBHTUxAHgkcDWWUuVYHG%2B9KcXY878%2B0nFibZJuHdYFlGcNB44ZhVmM4KuVnZwsMSXzQE%2FDgomNWqeE6rdPbUyYT%2B3rsU%2BL7rlvE9%2BSgVju7ernYSi6VnWvwu%2Ft5TjMFCmnewMUwNgo5HzdI%7Ctkp%3ABFBM2JGx2r5l",
          "price": [
            {
              "raw": "$62.99"
            }
          ],
          "thumbnail": "https://i.ebayimg.com/images/g/5ccAAOSwyDZnlB5M/s-l500.webp",
          "quantity_sold": "26 watchers",
          "seller": [
            {
              "username": "bigdeals"
            }
          ]
        },
        "..."
      ]
    }
  ],
  "organic_results": [
    {
      "start_price": "$2.84",
      "shipping": [
        {
          "raw": "Free delivery"
        }
      ],
      "thumbnail": "https://i.ebayimg.com/images/g/j-oAAeSwM1tn5~3H/s-l500.webp",
      "promotion": "Save up to 13% when you buy more",
      "link": "https://www.ebay.com/itm/356626588103?_skw=Coffee&var=625592313870&itmmeta=01JQTTC91H7ZB761NNWRWKMY2F&hash=item530899e1c7:g:j-oAAeSwM1tn5~3H&itmprp=enc%3AAQAKAAAA4FkggFvd1GGDu0w3yXCmi1dRCZEZByOZIOoeb06nolbgv28s7JAFhxZ2xqjO%2BQCoIwmyIpMuz1cFf1%2Bz92BEfdpt%2F60Ptl3hCNIHBnvMA9kLi3c2JIzbbn9o%2FwQCYf%2FdtLaSgGhMFZ%2BCIOkHan0m8VWBnfEuE1g%2Fq7JHuCo9Yd7yIIp%2Bt3qk8pDdYq552xx%2Fx3%2Fn0YJrQxXuatWq%2Bls2fPJP%2F6PQ1HJ0pVCYvAjL%2FL5RYB5HGwKUD1RYxCeRmGOKDNoKf%2B74eDzskhkBTwSMuO1apB3yUw2tlsWvFoZ0ZqpL%7Ctkp%3ABFBMmpGx2r5l",
      "condition": "Brand New",
      "end_price": "$18.99",
      "seller": [
        {
          "reviews": "3245",
          "positive_feedback_in_percentage": "99.2",
          "username": "weicuihua"
        }
      ],
      "old_price": [
        {
          "raw": "$2.99",
          "discount": "5% off"
        }
      ],
      "sponsored": true,
      "title": "Mushroom Coffee-Organic Coffee Supplement - Boost Energy 22/38/80 ServingsOpens in a new window or tab"
    },
    {
      "link": "https://www.ebay.com/itm/114300905102?_skw=Coffee&var=414553691594&itmmeta=01JQTTC91J6FMXRDCAG3R1FXE5&hash=item1a9cdd668e:g:HW8AAOSwPeNfC1kY&itmprp=enc%3AAQAKAAAA4FkggFvd1GGDu0w3yXCmi1dFIOlDi0d8aTtfdosGppisI2hOJYBdDVfps1YjB6S9F29TLhoZEDGRUrW0vttf5QrTv3%2B1fiYvEU8HU6HjjRlFkFN7dom33tBAuy1CPF3pKqlqBXuPX4rgKTTWfIUwVxUeuAHvqr00474YBjNqhboRWsc40yBFjyO8UTJu2UErnk9tFqiw6Qrjl5h1Otdl0oTR5muODI6C1LDPWJd9gJCQ4KQcUl2Eb8ehXa9QkdBW3LTXQbpzqoERWVC2ZV3Tm%2BJGDfPvqHaQ%2FPy2GS3CdsmS%7Ctkp%3ABFBMmpGx2r5l",
      "condition": "You Can Buy A Cheaper Coffee But Never A Finer Coffee !Brand New",
      "end_price": "$199.95",
      "seller": [
        {
          "username": "bluemacawcoffeeroasters",
          "reviews": "68924",
          "positive_feedback_in_percentage": "99.9"
        }
      ],
      "sponsored": true,
      "title": "100% JAMAICAN BLUE MOUNTAIN COFFEE BEANS MEDIUM ROASTED 2 TO 12 POUNDSOpens in a new window or tab",
      "start_price": "$57.95",
      "shipping": [
        {
          "raw": "+$3.99 delivery"
        }
      ],
      "thumbnail": "https://i.ebayimg.com/images/g/HW8AAOSwPeNfC1kY/s-l500.webp",
      "quantity_sold": "71+ sold"
    },
    {
      "sponsored": true,
      "title": "NEW Organic Mushroom Coffee 60 Servings Per Pack Free Shipping US StockOpens in a new window or tab",
      "link": "https://www.ebay.com/itm/356663743220?_skw=Coffee&var=625623720564&itmmeta=01JQTTC91KHQAV9Z568AAEABKX&hash=item530ad0d2f4:g:Z6MAAeSw8bpn0uXv&itmprp=enc%3AAQAKAAAA4FkggFvd1GGDu0w3yXCmi1dFGXNsOsqwNeg%2BEYYeU08rS2IUqtvF%2BK0AYN3cxohYWcisboVgPFuRwlS2AxPVhsraZQNZaftSibU3X6GWV0Juc0958ff4xdgKYUmb6E27tBihuL7ZL%2FA8OA8Rmc4retZhQhTbA%2BGy%2F00luBIXFB6BNf9R47WL78plFPDwdMXismvtZ2AOIVHLTihTbGIUXDRYvSbqGdAeLPDSQbe5A1Y9UrLd12R50ek5Fj3pwffPDxOGT4l%2FUtYcpIQ1kHpdDMYTo7gTT4%2F276HlU6%2F9nACa%7Ctkp%3ABFBMopGx2r5l",
      "end_price": "$32.19",
      "old_price": [
        {
          "raw": "$13.88",
          "discount": "5% off"
        }
      ],
      "condition": "Brand New",
      "start_price": "$13.19",
      "shipping": [
        {
          "raw": "Free delivery"
        }
      ],
      "thumbnail": "https://i.ebayimg.com/images/g/Z6MAAeSw8bpn0uXv/s-l500.webp",
      "promotion": "Save up to 13% when you buy more",
      "seller": [
        {
          "username": "weicuihua",
          "reviews": "3245",
          "positive_feedback_in_percentage": "99.2"
        }
      ]
    }
    "..."
  ],
  "categories": [
    {
      "name": "All"
    },
    {
      "name": "Kitchen, Dining & Bar",
      "id": "20625"
    },
    {
      "id": "14308",
      "name": "Food & Beverages"
    },
    "..."
  ]
}

Response Fields

Field	Type	Description
search_metadata	object	Contains timing and status information
search_parameters	object	Contains query parameters and search context
inline_results	object[]	InlineResults
organic_results	object[]	OrganicResults
categories	object[]	Categories

---

Error Responses

Common Errors

HTTP Status	Error Code	Description
200	400	API Key can not be empty
200	401	Param error
200	402	Api key error
200	403	Insufficient Balance
200	404	Deduction failed
200	405	Failed to record usage count
200	406	Unsupported engine
200	407	Network error
200	408	File not found
200	409	Limit param error
200	410	Build url error
200	411	Failed to QueryRecentRecord
200	412	Failed to find json
200	413	Get html error
200	414	HTML is empty
200	429	Too many request

Error Example

{
  "code": 400,
  "message": "API Key can not be empty"
}

---