Catalog API
ebay · Commerce
The Catalog API allows users to search for and locate an eBay catalog product that is a direct match for the product that they wish to sell. Listing against an eBay catalog product helps insure that all listings (based off of that catalog product) have complete and accurate information. In addition to helping to create high-quality listings, another benefit to the seller of using catalog information to create listings is that much of the details of the listing will be prefilled, including the li
Authentication
Sample Requests
This method searches for and retrieves summaries of one or more products in the eBay catalog that match the search criteria provided by a seller. The seller can use the summaries to select the product in the eBay catalog that corresponds to the item that the seller wants to offer for sale. When a co
Hover any highlighted part to learn what it does
curl -X GET "https://api.apis.guru/v2/specs/ebay.com/commerce-catalog/v1_beta.5.0/product_summary/search?q=test&mpn=example>in=example&limit=10&offset=0&fieldgroups=example&category_ids=example&aspect_filter=example"
import requests
params = {
"q": "test",
"mpn": "example",
"gtin": "example",
"limit": "10",
"offset": "0",
"fieldgroups": "example",
"category_ids": "example",
"aspect_filter": "example"
}
response = requests.get(
"https://api.apis.guru/v2/specs/ebay.com/commerce-catalog/v1_beta.5.0/product_summary/search",
params=params,
)
print(response.json())const url = new URL('https://api.apis.guru/v2/specs/ebay.com/commerce-catalog/v1_beta.5.0/product_summary/search');
url.searchParams.set('q', 'test');
url.searchParams.set('mpn', 'example');
url.searchParams.set('gtin', 'example');
url.searchParams.set('limit', '10');
url.searchParams.set('offset', '0');
url.searchParams.set('fieldgroups', 'example');
url.searchParams.set('category_ids', 'example');
url.searchParams.set('aspect_filter', 'example');
const response = await fetch(url);
const data = await response.json();
console.log(data);package main
import (
"fmt"
"io"
"net/http"
"net/url"
)
func main() {
baseURL, _ := url.Parse("https://api.apis.guru/v2/specs/ebay.com/commerce-catalog/v1_beta.5.0/product_summary/search")
q := baseURL.Query()
q.Set("q", "test")
q.Set("mpn", "example")
q.Set("gtin", "example")
q.Set("limit", "10")
q.Set("offset", "0")
q.Set("fieldgroups", "example")
q.Set("category_ids", "example")
q.Set("aspect_filter", "example")
baseURL.RawQuery = q.Encode()
targetURL := baseURL.String()
req, _ := http.NewRequest("GET", targetURL, nil)
client := &http.Client{}
resp, _ := client.Do(req)
defer resp.Body.Close()
body, _ := io.ReadAll(resp.Body)
fmt.Println(string(body))
}require "net/http"
require "json"
uri = URI("https://api.apis.guru/v2/specs/ebay.com/commerce-catalog/v1_beta.5.0/product_summary/search")
uri.query = URI.encode_www_form({
"q" => "test",
"mpn" => "example",
"gtin" => "example",
"limit" => "10",
"offset" => "0",
"fieldgroups" => "example",
"category_ids" => "example",
"aspect_filter" => "example"
})
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = uri.scheme == "https"
req = Net::HTTP::Get.new(uri)
res = http.request(req)
puts JSON.parse(res.body)<?php
$url = "https://api.apis.guru/v2/specs/ebay.com/commerce-catalog/v1_beta.5.0/product_summary/search?" . http_build_query([
"q" => "test",
"mpn" => "example",
"gtin" => "example",
"limit" => "10",
"offset" => "0",
"fieldgroups" => "example",
"category_ids" => "example",
"aspect_filter" => "example"
]);
$opts = ["http" => [
"method" => "GET",
]];
$ctx = stream_context_create($opts);
$res = file_get_contents($url, false, $ctx);
print_r(json_decode($res, true));This method retrieves details of the catalog product identified by the eBay product identifier (ePID) specified in the request. These details include the product's title and description, aspects and their values, associated images, applicable category IDs, and any recognized identifiers that apply t
Hover any highlighted part to learn what it does
curl -X GET "https://api.apis.guru/v2/specs/ebay.com/commerce-catalog/v1_beta.5.0/product/{epid}"import requests
response = requests.get(
"https://api.apis.guru/v2/specs/ebay.com/commerce-catalog/v1_beta.5.0/product/{epid}",
)
print(response.json())const url = 'https://api.apis.guru/v2/specs/ebay.com/commerce-catalog/v1_beta.5.0/product/{epid}';
const response = await fetch(url);
const data = await response.json();
console.log(data);package main
import (
"fmt"
"io"
"net/http"
)
func main() {
targetURL := "https://api.apis.guru/v2/specs/ebay.com/commerce-catalog/v1_beta.5.0/product/{epid}"
req, _ := http.NewRequest("GET", targetURL, nil)
client := &http.Client{}
resp, _ := client.Do(req)
defer resp.Body.Close()
body, _ := io.ReadAll(resp.Body)
fmt.Println(string(body))
}require "net/http"
require "json"
uri = URI("https://api.apis.guru/v2/specs/ebay.com/commerce-catalog/v1_beta.5.0/product/{epid}")
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = uri.scheme == "https"
req = Net::HTTP::Get.new(uri)
res = http.request(req)
puts JSON.parse(res.body)<?php
$url = "https://api.apis.guru/v2/specs/ebay.com/commerce-catalog/v1_beta.5.0/product/{epid}";
$opts = ["http" => [
"method" => "GET",
]];
$ctx = stream_context_create($opts);
$res = file_get_contents($url, false, $ctx);
print_r(json_decode($res, true));Postman Setup Guide
- See official documentation for authentication and setup.
What can you build with Catalog API?
Catalog API is a Commerce API. Developers commonly use commerce APIs for:
- syncing product catalogues and inventory levels
- building price comparison and deal-finder tools
- processing orders and tracking shipments
- managing customer wishlists and reviews
- automating abandoned-cart and promotional emails
No authentication required. This API is open — no signup or key needed. Ideal for quick prototypes and public-facing features. Catalog API is free to use, making it a low-risk choice to experiment with.
New to APIs? Read our beginner's guide · Learn about API keys · What is REST?