Ebay Item Feed Service
Browse all Ebay APIs69
AI ReadinessAI-Aware (B+)69/100
Official vendor OpenAPI document · agent-readyE CommerceStorefrontoauth24 EndpointsREST
For Agents
Download bulk eBay item feed files (full and hourly snapshots) by category and marketplace for offline catalogue ingestion. Limited Release access only.
Use for: Download today's full item feed for the Electronics category on the US marketplace, I want to grab the hourly snapshot of changed items in Fashion, Retrieve the item-group feed for Home & Garden with variation data, Get the priority item feed for the Motors category
Not supported: Does not handle item-level lookup, search, or pricing queries - use for bulk per-category catalogue downloads only.
The eBay Item Feed Service lets approved Buy API partners download bulk TSV_GZIP feed files of eBay items by category, marketplace, and date, plus hourly snapshot files of items that have changed within the last hour. Agents and applications can ingest the full eBay catalogue offline rather than scraping listings or paginating through search. Access is gated to Limited Release partners - applications must be approved by eBay business units before this service can be used in production.
Install Jentic One Beta
Connect the Item Feed Service to your agent
Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Item Feed Service, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.
Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.
1
Step 1: Jentic One Host machine
# On the machine that will host your Jentic One instance:
curl -fsSL "https://jentic.com/install.sh?src=apis&api=%2Fapis%2Febay.com%2Fbuy-feed" | sh2
Step 2: Agent machine
# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL "https://jentic.com/install.sh?src=apis&api=%2Fapis%2Febay.com%2Fbuy-feed" | sh
jentic register # connects your agent to your Jentic One instanceJentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.
Capabilities
What an agent can do with Item Feed Service API.
Download a full TSV_GZIP item feed for a category and marketplace on a given date
Pull an hourly snapshot of items that changed within the last hour for a category
Retrieve item-group feed files to capture variation-level listings in bulk
Fetch priority item feeds for promoted or business-relevant inventory subsets
Stream multi-gigabyte feed files using HTTP Range requests for resumable downloads
Filter the resulting feeds with the open-source eBay Feed SDK to curate items by aspect
Use Cases
Patterns agents use Item Feed Service API for, with concrete tasks.
★ Bulk catalogue ingestion for a price-monitoring agent
Approved partners use the Item Feed Service to download daily full-category TSV_GZIP files instead of paginating through Browse search. A monitoring agent can ingest tens of millions of listings per day per marketplace, then run hourly snapshot files to keep its mirror current. The Feed SDK handles chunked download, resume on failure, and field-level filtering so the agent only stores the columns it needs.
Download today's full item feed for category 9355 on EBAY_US, then pull the hourly snapshot file produced in the last hour and merge changed item IDs into the local mirror
Variation-aware product reconciliation
The /item_group endpoint returns feed files of items with variations (size, colour, configuration) grouped by parent listing. Resellers and aggregators reconcile their internal SKUs against eBay variation IDs without writing per-item Browse calls. One feed file replaces tens of thousands of /item/get_items_by_item_group requests from the Browse API.
Download the item_group feed for category 11450 on EBAY_GB and emit a CSV of parent-listing-ID to variation-ID mappings
Promoted listings and priority inventory tracking
The /item_priority resource exposes feeds of items flagged as priority by eBay (promoted or business-managed inventory subsets). Affiliate networks and demand-side platforms ingest these feeds to keep their ad inventory aligned with what eBay is actively pushing, with new files published on the standard daily cadence.
Pull the latest /item_priority feed for EBAY_US and write the item IDs to a downstream advertising bid table
AI agent integration via Jentic
An AI agent that monitors eBay catalogue movements queries Jentic for 'download bulk eBay item feed' and Jentic returns the Item Feed Service /item operation with its required parameters (category_id, date, marketplace). The agent loads the schema, executes the call with a partner OAuth token issued through Jentic's vault, and streams the TSV_GZIP file to local storage - without storing the OAuth secret in agent memory.
Use Jentic to search 'download bulk eBay item feed', load the /item operation schema, and execute it for category 9355 on EBAY_US for today's date
Key Endpoints
4 endpoints — the ebay item feed service lets approved buy api partners download bulk tsv_gzip feed files of ebay items by category, marketplace, and date, plus hourly snapshot files of items that have changed within the last hour.
METHOD
PATH
DESCRIPTION
GET
/item
Download a full TSV_GZIP item feed by category, date, and marketplace
GET
/item_group
Download an item-group feed with variation data
GET
/item_priority
Download a priority item feed
GET
/item_snapshot
Download an hourly snapshot of changed items
GET
/item
Download a full TSV_GZIP item feed by category, date, and marketplace
GET
/item_group
Download an item-group feed with variation data
GET
/item_priority
Download a priority item feed
GET
/item_snapshot
Download an hourly snapshot of changed items
Jentic AI Readiness Score
This API is usable in Jentic One now. Its AI-readiness score against Jentic's framework shows where it stands today and where improvements would make it even easier for agents to use.
I
Item Feed Service
- AI-Aware (B+)69/100
100
Foundational Compliance69
Developer Experience & Jentic Compatibility47
AI-Readiness & Agent Experience94
Agent Usability85
Security63
AI DiscoverabilityPowered by JenticScoring Framework 1.0.0 | Scoring Engine 0.4.0
Show dimension breakdown
100
Foundational Compliance
Base layer of spec validity and structural soundness.
Grade: A+Signals: 4
98%
Lint Results
Aggregated quality score from linter diagnostics, weighted by severity.
100%
Resolution Completeness
Percentage of `$ref` references that resolve successfully.
100%
Specification Validity
Checks whether the API description parses successfully and conforms to its declared specification (e.g., OpenAPI).
100%
Structural Integrity
Structural correctness score based on schema issues using logarithmic dampening.
69
Developer Experience & Jentic Compatibility
Clarity, completeness, and ingestion readiness for developers and tooling.
Grade: B+Signals: 4
0%
Example Density
How richly the API is illustrated with examples.
100%
Example Validity
Percentage of examples that conform to their schemas.
75%
Response Coverage
Percentage of operations with complete response definitions (success, client error, server error).
100%
Tooling Readiness
Health of API ingestion, bundling, and resolution within Jentic pipelines.
47
AI-Readiness & Agent Experience
Semantic breadth, depth, and agent comprehension for AI systems.
Grade: DSignals: 4
87%
Description Coverage
Coverage of descriptions across API elements.
0%
Error Standardization
Coverage of RFC 9457 Problem Details for error responses.
100%
OperationId Quality
Coverage, uniqueness, and casing consistency of operationIds for AI inference.
0%
Summary Coverage
Coverage of summaries across operations/tags/info.
94
Agent Usability
Functional utility, complexity comfort, and AI orchestration readiness.
Grade: A+Signals: 1
94%
Complexity Comfort
Agent comfort level based on API operational and structural complexity.
85
Security
Trust, risk posture, and security compliance.
Grade: ASignals: 1
85%
Authentication Strength
Average quality of security schemes based on authentication method strength (weakest link for OAuth2).
63
AI Discoverability
Findability, semantic richness, and reasoning readiness.
Grade: B-Signals: 1
62%
Descriptive Richness
Clarity and depth of descriptions across API elements.
Score it yourself
Every API in the directory is allowlisted, so you can re-score it with no key required.
npx @jentic/api-scorecard-cli score <openapi-url>Why Jentic?
What agents get from Jentic-routed access to this vendor.
Setup
Wiring the eBay Item Feed Service by hand means running the OAuth 2.0 client-credentials flow for the buy.item.feed scope, caching the token, and setting the required category, date, and marketplace parameters on each bulk download. Through Jentic you install once, import the Item Feed Service from the API Directory, store the client credentials once, and your agent calls it.
Permission scoping
The Item Feed Service selects feeds through query parameters like category_id and marketplace_id rather than URL path segments, so scope your agent to the operations it needs, such as downloading an item feed or an item snapshot. Other feed types stay out of the allowed set unless you add them.
Credential isolation
Your eBay OAuth client credentials are stored once, encrypted, by your own Jentic One instance, which exchanges them for a scoped token and injects it at execution time. The raw client secret never enters the agent's prompt, logs, or context.
Intent-based discovery
Agents search Jentic by intent such as 'download bulk eBay item feed', and Jentic returns the matching /item or /item_snapshot operation with its required parameters, including category_id, date, and marketplace_id, so the agent calls the right endpoint without browsing the reference docs.
Related APIs
Alternatives and complements available in the Jentic catalogue.
FAQs
Specific to using Item Feed Service API through Jentic.
What authentication does the Item Feed Service use?
The Item Feed Service uses OAuth 2.0 with the Client_Credentials grant. Partners obtain an Application access token scoped to https://api.ebay.com/oauth/api_scope/buy.item.feed and pass it as a Bearer token. Through Jentic, the OAuth client secret is held in your Jentic One instance and the agent receives a scoped access token only - the raw secret never enters agent context.
Can I download the entire eBay catalogue with the Item Feed Service?
You can download per-category daily full feeds (/item) plus hourly snapshot files (/item_snapshot), but only for categories and marketplaces your partner application has been approved for. There is no single endpoint that returns every listing on eBay - feeds are partitioned by category_id, date, and marketplace_id (e.g. EBAY_US).
What are the rate limits for the Item Feed Service?
Feed downloads are governed by eBay's Buy APIs rate limits, which are issued per application and per partner agreement rather than as a fixed public quota. Daily call counts are visible through the Developer Analytics API. Because each download can be multi-gigabyte, the practical bottleneck is bandwidth and HTTP Range chunking, not call count.
How do I download an item snapshot file through Jentic?
Search Jentic for 'download eBay item snapshot', load the /item_snapshot operation schema, and execute it with category_id, snapshot_date (ISO 8601 hour), and marketplace_id. Install with pip install jentic and call client.search, client.load, then client.execute. Get started with Jentic One, the self-hosted execution layer.
Is the Item Feed Service free?
The API itself has no per-call charge, but it is a Limited Release service - you must be approved by an eBay business unit before production access is granted. Apply through the Buy APIs Requirements page on developer.ebay.com.
What format are the feed files returned in?
Feed files are returned as TSV_GZIP - tab-separated values, gzip-compressed. The open-source eBay Feed SDK (Java) handles chunked download, decompression, and field-level filtering, and is the recommended client for production ingestion.
Can I limit what my agent is allowed to do with the eBay Item Feed API?
Yes. Because you run Jentic One yourself, your own rules decide which Item Feed operations the agent may call, so you can allow only the ones it needs, such as downloading a full item feed or pulling an hourly item snapshot, while keeping item_group and item_priority feeds out of the allowed set. Since feeds are selected through query parameters like category_id and marketplace_id rather than URL path segments, scoping is done per operation. Your eBay OAuth client credentials stay stored in your own instance and are exchanged for a scoped token at execution time, so the agent never sees the raw secret.
GET STARTED