GET/item_snapshot
The Hourly Snapshot feed file is generated each hour every day for most categories. This method lets you download an Hourly Snapshot TSV_GZIP (tab-separated value gzip) feed file containing the details of all the items that have changed within the specified day and hour for a specific category. This means to generate the 8AM file of items that have changed from 8AM and 8:59AM, the service starts at 9AM. You can retrieve the 8AM snapshot file at 10AM.
Snapshot feeds now include new listings. You can check itemCreationDate to identify listings that were newly created within the specified hour.
Note: Filters are applied to the feed files. For details, see Feed File Filters. When curating the items returned, be sure to code as if these filters are not applied as they can be changed or removed in the future.
You can use the response from this method to update the item details of items stored in your database. By looking at the value of itemSnapshotDate for a given item, you will be able to tell which information is the latest.
Important: When the value of the availability column is UNAVAILABLE
, only the itemId and availability columns are populated.
Note:The downloaded file will be gzipped automatically, so there is no reason to supply Accept-Encoding:gzip as a header. If this header is supplied, the downloaded file will be compressed twice, and this has no extra benefit.
Downloading feed files
Hourly snapshot feed files are binary gzip files. If the file is larger than 100 MB, the download must be streamed in chunks. You specify the size of the chunks in bytes using the Range request header. The Content-range response header indicates where in the full resource this partial chunk of data belongs and the total number of bytes in the file. For more information about using these headers, see Retrieving a gzip feed file.Note: A successful call will always return a TSV.GZIP file; however, unsuccessful calls generate errors that are returned in JSON format. For documentation purposes, the successful call response is shown below as JSON fields so that the value returned in each column can be explained. The order of the response fields shows the order of the columns in the feed file.
Restrictions
For a list of supported sites and other restrictions, see API Restrictions.Input
Resource URI
This method is supported in Sandbox environment. To access the endpoint, just replace the api.ebay.com
root URI with api.sandbox.ebay.com
URI parameters
Parameter | Type | Description |
---|---|---|
category_id | string | This query parameter specifies the eBay top-level category ID of the items to be returned in the feed file. The list of eBay category IDs changes over time and category IDs are not the same across all the eBay marketplaces. To get a list of the top-level categories for a marketplace, you can use the Taxonomy API getCategoryTree method. This method retrieves the complete category tree for the marketplace. The top-level categories are identified by the categoryTreeNodeLevel field. For example: "categoryTreeNodeLevel": 1 For details see Get Categories for Buy APIs. Restriction: Must be a top-level category other than Real Estate. Items listed under Real Estate L1 categories are excluded from all feeds in all marketplaces. Occurrence: Required |
snapshot_date | string | This query parameter specifies the date and hour of the snapshot feed file you want to retrieve. Each file contains the items that changed within the hour in the specified category. So, the 9AM file contains the items that changed between 9AM and 9:59AM on the day specified. It takes 2 hours to generate a snapshot file, which means to get the file for 9AM the earliest you could submit the call is at 11AM. There are 7 days of Hourly Snapshot feed files available. Note: The Feed API uses GMT, so you must convert your local time to GMT. For example, if you lived in California and wanted the September 15th 7pm file, you would submit the following call: yyyy-MM-ddThh:00:00.000Z Note: Files are generated on the hour, so minutes and seconds are always zeros. Occurrence: Required |
HTTP request headers
All requests made to eBay REST operations require you to provide the Authorization
HTTP header for authentication authorization.
The table below shows additional HTTP request headers that are either required, conditionally required, or strongly recommended for this method. Other standard HTTP request headers- opens rest request components page (not in this table) can also be used, but they are optional.
Header | Type | Description |
---|---|---|
Accept | string | The formats that the client accepts for the response. A successful call will always return a TSV.GZIP file; however, unsuccessful calls generate error codes that are returned in JSON format. Default: application/json,text/tab-separated-values Occurrence: Required |
X-EBAY-C-MARKETPLACE-ID | string | The ID of the eBay marketplace where the item is hosted. This value is case sensitive. For example: X-EBAY-C-MARKETPLACE-ID = EBAY_US For a list of supported sites see, API Restrictions. Occurrence: Required |
Range | string | This header specifies the range in bytes of the chunks of the gzip file being returned. Format: bytes=startpos-endpos For example, the following retrieves the first 10 MBs of the feed file. Range bytes=0-10485760 For more information about using this header, see Retrieving a gzip feed file. Maximum: 100 MB (10MB in the Sandbox) Occurrence: Required |
OAuth scope
This request requires an access token created with the client credentials grant flow, using one or more scopes from the following list (please check your Application Keys page for a list of OAuth scopes available to your application):
https://api.ebay.com/oauth/api_scope/buy.item.feed
See OAuth access tokens for more information.
Request payload
This call has no payload.
Request fields
This call has no field definitions.
Output
HTTP response headers
See HTTP response headers for details.
Header | Meaning |
---|---|
Content-range | The content-range response header indicates where in the full resource this partial chunk of data belongs. It returns the lower and upper values in bytes (specified by the Range header) of the chunk and the total size of the file being downloaded in bytes. Maximum range: 100 MB The following is an example of a content-range response, where 0-10 is the lower and upper limit in bytes and 1000 is the total size of the file in bytes. 0-10/1000 The following example of a content-range response indicates the value of the Range header is invalid and a 416 status code is returned. */1000 For more information and examples, see Retrieving a gzip feed file. |
Last-Modified | Returns the generated date of the feed file, which will be the latest file available. For example: Last-Modified Wed, 21 Oct 2015 07:28:00 GMT |
Response payload
Important: The successful response of this call is always a TSV_GZIP file. However, the response is shown as JSON fields for each column so that the value returned in each column can be explained. The order in which the response fields are listed is the order of the columns in the feed file.
Response fields
Output container/field | Type | Description | ||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
items | array of ItemSnapshot | The container for the array of items returned by the getItemSnapshotFeed method. Note: When the value of the availability column is Occurrence: Conditional | ||||||||||||
items.itemId | string | The unique identifier of an item in eBay RESTful format. An example would be Occurrence: Always | ||||||||||||
items.availability | AvailabilityEnum | An enumeration value representing the item's availability (possibility of being purchased).
Occurrence: Always | ||||||||||||
items.title | string | The seller created title of the item. This text is an escaped string when special characters are present, using the following rules:
For example Before:
After:
Occurrence: Conditional | ||||||||||||
items.imageUrl | string | The URL to the primary image of the item. This is the URL of the largest image available based on what the seller submitted. Occurrence: Conditional | ||||||||||||
items.category | string | The label of the category of the item. For example: Toys & Hobbies|Action Figures|Comic Book Heroes . Occurrence: Conditional | ||||||||||||
items.categoryId | string | The ID of the category of the item. For example: The ID for Toys & Hobbies|Action Figures|Comic Book Heroes is Occurrence: Conditional | ||||||||||||
items.buyingOptions | string | A comma separated list of the purchase options available for the item. Currently the only supported option is Important! This field no longer returns values and is scheduled for deprecation. Occurrence: Always | ||||||||||||
items.sellerUsername | string | The seller's eBay user name. Occurrence: Conditional | ||||||||||||
items.sellerFeedbackPercentage | string | The percentage of the seller's total positive feedback. Occurrence: Conditional | ||||||||||||
items.sellerFeedbackScore | string | The feedback score of the seller. This value is based on the ratings from eBay members that bought items from this seller. Occurrence: Conditional | ||||||||||||
items.gtin | string | The unique Global Trade Item Number of the item as defined by https://www.gtin.info. This can be a UPC (Universal Product Code), EAN (European Article Number), or an ISBN (International Standard Book Number) value. Occurrence: Conditional | ||||||||||||
items.brand | string | The name brand of the item, such as Nike, Apple, etc. Occurrence: Conditional | ||||||||||||
items.mpn | string | The manufacturer part number, which is a number that is used in combination with brand to identify a product. Occurrence: Conditional | ||||||||||||
items.epid | string | The eBay product identifier of a product from the eBay product catalog. You can use this value in the Browse API search method to retrieve items for this product and in the Marketing API methods to retrieve 'also viewed' and 'also bought' products to encourage up-selling and cross-selling. Occurrence: Conditional | ||||||||||||
items.conditionId | string | The identifier of the condition of the item. For example, 1000 is the identifier for NEW. For a list of condition names and IDs, see Item Condition IDs and Names. Occurrence: Conditional | ||||||||||||
items.condition | string | The text describing the condition of the item, such as New or Used. For a list of condition names, see Item Condition IDs and Names. Occurrence: Conditional | ||||||||||||
items.priceValue | string | The price of the item, which can be a discounted price. Occurrence: Conditional | ||||||||||||
items.priceCurrency | CurrencyCodeEnum | The currency used for the price of the item. Generally, this is the currency used by the country of the eBay site offering the item. Occurrence: Conditional | ||||||||||||
items.primaryItemGroupId | string | The unique identifier for the item group that contains this item. An item group is an item that has various aspect differences, such as color, size, storage capacity, etc. Occurrence: Conditional | ||||||||||||
items.primaryItemGroupType | string | The item group type. Supported value: Important! This field no longer returns values and is scheduled for deprecation. Occurrence: Conditional | ||||||||||||
items.itemEndDate | string | A timestamp indicating when the item's sale period will end based on its start date and duration. For Good 'Til Cancelled items, no value is returned in this column. Occurrence: Conditional | ||||||||||||
items.sellerItemRevision | string | An identifier generated/incremented when a seller revises the item. There are two types of item revisions:
Occurrence: Conditional | ||||||||||||
items.itemLocationCountry | string | The country where the item is physically located. Occurrence: Conditional | ||||||||||||
items.localizedAspects | string | A semicolon separated list of the name/value pairs for the aspects of the item, which are Base64 encoded. The aspect label is separated by a pipe (|), the aspect name and value are separated by a colon (:) and the name/value pairs are separated by a semicolon (;). Example without Label Encoded Format: Encoded Example (The delimiters are emphasized): Decoded:
Encoded Format: Encoded Example (The delimiters are emphasized): Decoded: Note: The separators ( For more information, see Encoded Aspects in the Buying Integration Guide. Occurrence: Conditional | ||||||||||||
items.sellerTrustLevel | SellerTrustLevelEnum | An enumeration value representing the eBay status of the seller. Occurrence: Conditional | ||||||||||||
items.imageAlteringProhibited | boolean | A boolean that indicates whether the images can be altered. If the value is Note: Due to image licensing agreements and other legal concerns, modification (including resizing) of some images is strictly prohibited. These images are for display as-is only. Occurrence: Conditional | ||||||||||||
items.estimatedAvailableQuantity | integer | The estimated quantity of this item that are available for purchase. Because the quantity of an item can change several times within a second, it is very difficult to return the exact quantity. So instead of returning quantity, the estimated availability of the item is returned. Occurrence: Conditional | ||||||||||||
items.availabilityThresholdType | AvailabilityThresholdEnum | This column has a value only when the seller sets their availability threshold preference. The value of this column will show Occurrence: Conditional | ||||||||||||
items.availabilityThreshold | integer | This column has a value only when the seller sets their availability threshold preference. Occurrence: Conditional | ||||||||||||
items.itemSnapshotDate | string | This timestamp denotes the date and time the changes for that item were picked up and added to the snapshot feed file. Occurrence: Conditional | ||||||||||||
items.originalPriceValue | string | The original selling price of the item. This lets you surface a strikethrough price for the item. Occurrence: Conditional | ||||||||||||
items.originalPriceCurrency | CurrencyCodeEnum | The currency of the originalPriceValue of the item and the discountAmount. Occurrence: Conditional | ||||||||||||
items.discountAmount | string | The calculated amount of the discount (originalPriceValue - priceValue). For example, if originalPriceValue is 70 and priceValue is 56, this value would be 14. Occurrence: Conditional | ||||||||||||
items.discountPercentage | string | The calculated discount percentage. For example, if originalPriceValue is 70 and discountAmount is 14, this value will be 20. Occurrence: Conditional | ||||||||||||
items.returnsAccepted | boolean | Indicates whether the seller accepts returns for the item. Occurrence: Conditional | ||||||||||||
items.returnPeriodValue | integer | The amount of days that the buyer has to return the item after the purchase date. For example, if this value is Occurrence: Conditional | ||||||||||||
items.returnPeriodUnit | TimeDurationUnitEnum | An enumeration value that indicates the period of time being used to measure the duration, such as business days, months, or years. Occurrence: Conditional | ||||||||||||
items.refundMethod | RefundMethodEnum | An enumeration value representing how a buyer is refunded when an item is returned. Important! This field no longer returns values and is scheduled for deprecation. Occurrence: Conditional | ||||||||||||
items.returnMethod | ReturnMethodEnum | An enumeration value that indicates the alternative methods for a full refund when an item is returned. This column will have data if the seller offers the buyer an item replacement or exchange instead of a monetary refund. Important! This field no longer returns values and is scheduled for deprecation. Occurrence: Conditional | ||||||||||||
items.returnShippingCostPayer | ReturnShippingCostPayerEnum | An enumeration value that indicates the party responsible for the return shipping costs when an item is returned. Occurrence: Conditional | ||||||||||||
items.energyEfficiencyClass | string | Indicates the European energy efficiency rating (EEK) of the item. This field is returned only if the seller specified the energy efficiency rating. Occurrence: Conditional | ||||||||||||
items.additionalImageUrls | string | A pipe separated ( Occurrence: Conditional | ||||||||||||
items.deliveryOptions | DeliveryOptionsEnum | A comma-separated list of available delivery options. This column lets you filter out items than cannot be shipped to the buyer. Occurrence: Conditional | ||||||||||||
items.shipToIncludedRegions | string | A pipe ( Occurrence: Conditional | ||||||||||||
items.shipToExcludedRegions | string | A pipe ( Occurrence: Conditional | ||||||||||||
items.acceptedPaymentMethods | string | This field is returned empty. For a list of payment methods available for a marketplace, see eBay help pages or the actual View Item page. Important! This field no longer returns values and is scheduled for deprecation. Occurrence: Conditional | ||||||||||||
items.qualifiedPrograms | string | A pipe separated list of the qualified programs available for the item, such as EBAY_PLUS and AUTHENTICITY_GUARANTEE. Occurrence: Conditional | ||||||||||||
items.lotSize | integer | The number of items in a lot. In other words, a lot size is the number of items that are being sold together.
Note: Lots are not supported in all categories. Occurrence: Conditional | ||||||||||||
items.shippingCarrierCode | string | The name of the shipping provider, such as FedEx, or USPS. Important! This field no longer returns values and is scheduled for deprecation. Occurrence: Conditional | ||||||||||||
items.shippingServiceCode | string | The type of shipping service. For example, USPS First Class. Important! This field no longer returns values and is scheduled for deprecation. Occurrence: Conditional | ||||||||||||
items.shippingType | string | The type of a shipping option, such as EXPEDITED, ONE_DAY, STANDARD, ECONOMY, PICKUP, etc. Occurrence: Conditional | ||||||||||||
items.shippingCost | string | The final shipping cost for all the items after all discounts are applied. Occurrence: Conditional | ||||||||||||
items.shippingCostType | string | Indicates the class of the shipping cost. Occurrence: Conditional | ||||||||||||
items.additionalShippingCostPerUnit | string | Any per item additional shipping costs for a multi-item purchase. For example, let's say the shipping cost for a power cord is $3. But for an additional cord, the shipping cost is only $1. So if you bought 3 cords, the shippingCost would be $3 and this value would be $2 ($1 for each additional item). Important! This field no longer returns values and is scheduled for deprecation. Occurrence: Conditional | ||||||||||||
items.quantityUsedForEstimate | integer | The number of items used when calculating the shipping estimation information. Important! This field no longer returns values and is scheduled for deprecation. Occurrence: Conditional | ||||||||||||
items.unitPrice | string | This is the price per unit for the item. Some European countries require listings for certain types of products to include the price per unit so buyers can accurately compare prices. Occurrence: Conditional | ||||||||||||
items.unitPricingMeasure | string | The designation, such as size, weight, volume, count, etc., that was used to specify the quantity of the item. This helps buyers compare prices. Occurrence: Conditional | ||||||||||||
items.inferredEpid | string | The ePID (eBay Product ID of a product in the eBay product catalog) for the item, which has been programmatically determined by eBay using the item's title, aspects, and other data. Occurrence: Conditional | ||||||||||||
items.itemCreationDate | string | A timestamp indicating when the item was created. Occurrence: Always | ||||||||||||
items.legacyItemId | string | The unique identifier of the eBay listing that contains the item. This is the traditional/legacy ID that is often seen in the URL of the listing View Item page. Occurrence: Always | ||||||||||||
items.alerts | string | A pipe-separated list of alerts available for the item. Occurrence: Conditional | ||||||||||||
items.sellerAccountType | string | A string value that specifies whether the seller is a business or an individual. This is determined when the seller registers with eBay. If the seller registers for a business account, the value returned in this field will be Occurrence: Conditional | ||||||||||||
items.tyreLabelImageUrl | string | The URL to the image that shows the information on the tyre label. Occurrence: Conditional | ||||||||||||
items.ageGroup | string | The age group that the product is recommended for. Occurrence: Conditional | ||||||||||||
items.color | string | The color of the item. Occurrence: Conditional | ||||||||||||
items.pattern | string | (Primary Item Aspect) Text describing the pattern used on the item. For example, paisley. Occurrence: Conditional | ||||||||||||
items.size | string | The size of the item. Occurrence: Conditional | ||||||||||||
items.gender | string | In cases where items could vary by gender, this specifies for which gender the product is intended. Possible values include male, female, and unisex. Occurrence: Conditional | ||||||||||||
items.material | string | The material that the item is made of. Occurrence: Conditional | ||||||||||||
items.totalUnits | string | For an item that is priced by the unit, the total number of units that are on offer. For example, if the item is priced by the meter and 50 cm is on offer, the totalUnits would be 0.5 m. Occurrence: Conditional | ||||||||||||
items.defaultImageUrl | string | URL to the gallery or default image of the item. The other images of the item are returned in the additionalImageUrls field. Occurrence: Conditional | ||||||||||||
items.itemWebUrl | string | The URL of the View Item page of the item. Occurrence: Conditional | ||||||||||||
items.itemAffiliateWebUrl | string | The URL of the View Item page of the item, with the affiliate tracking ID appended to it. Occurrence: Conditional | ||||||||||||
items.description | string | The seller created description of the item. Occurrence: Conditional | ||||||||||||
items.changeMetadata | string | Status change indicator of the listing.
Occurrence: Conditional | ||||||||||||
items.ecoParticipationFeeValue | string | The amount of the Eco Participation Fee, a fee paid toward the eventual disposal of the purchased item. Occurrence: Conditional | ||||||||||||
items.ecoParticipationFeeCurrency | string | The currency in which the Eco Participation Fee for the item is paid. Occurrence: Conditional | ||||||||||||
items.takeBackPolicyLabel | string | The seller-defined label of the TAKE_BACK custom policy for the item. A TAKE_BACK policy describes the seller's regulatory responsibility to take back a purchased item for disposal when the buyer purchases a new one. Occurrence: Conditional | ||||||||||||
items.takeBackPolicyDescription | string | The seller-defined description of the TAKE_BACK custom policy for the item. Occurrence: Conditional | ||||||||||||
items.authenticityGuaranteeServiceId | string | The unique identifier for the Authenticity Guarantee service associated with the item. Occurrence: Conditional | ||||||||||||
items.authenticityGuaranteeSelection | OptionalityEnum | An indication of whether the Authenticity Guarantee service is optional or mandatory for the item. Occurrence: Conditional | ||||||||||||
items.authenticityGuaranteeFeeValue | string | The price of the Authenticity Guarantee service for the item. Occurrence: Conditional | ||||||||||||
items.authenticityGuaranteeFeeCurrency | string | The currency used for the Authenticity Guarantee service fee. Occurrence: Conditional | ||||||||||||
items.couponDiscountType | string | The type of discount that the coupon applies. Occurrence: Conditional | ||||||||||||
items.couponRedemptionCode | string | The redemption code for the coupon. Occurrence: Conditional | ||||||||||||
items.couponMessage | string | A description of the coupon. Occurrence: Conditional | ||||||||||||
items.couponTermsWebUrl | string | The URL to the coupon terms of use. Occurrence: Conditional | ||||||||||||
items.couponDiscountValue | string | The discount amount after the coupon is applied. Occurrence: Conditional | ||||||||||||
items.couponDiscountCurrency | string | The currency used to specify the coupon discount value. Occurrence: Conditional | ||||||||||||
items.couponExpirationDate | string | The expiration date for the coupon. Occurrence: Conditional | ||||||||||||
items.hazmatSignalWordId | string | The ID of the signal word for the hazardous material. Occurrence: Conditional | ||||||||||||
items.hazmatSignalWord | string | The localized signal word for the hazardous material, such as 'Danger'. Occurrence: Conditional | ||||||||||||
items.hazmatStatementIds | string | The IDs of hazardous material statements, separated by the pipe symbol. For example: Occurrence: Conditional | ||||||||||||
items.hazmatStatementDescriptions | string | The Base64 encoded descriptions of hazardous material statements, separated by the pipe symbol. For example: Occurrence: Conditional | ||||||||||||
items.hazmatPictogramIds | string | The IDs of hazardous material pictograms, separated by the pipe symbol. For example: Occurrence: Conditional | ||||||||||||
items.hazmatPictogramDescriptions | string | The Base64 encoded descriptions of hazardous material pictograms, separated by the pipe symbol. For example: Occurrence: Conditional | ||||||||||||
items.hazmatPictogramImageUrls | string | The image URLs of hazardous material pictograms, separated by the pipe symbol. For example: Occurrence: Conditional | ||||||||||||
items.hazmatAdditionalInformation | string | Base64 encoded additional information about the hazardous material. Occurrence: Conditional | ||||||||||||
items.repairScore | string | A score that describes how easy it is to repair the product. Score values range from 0.1 (hardest to repair) to 10.0 (easiest), always including a single decimal place. Occurrence: Conditional | ||||||||||||
items.conditionDescriptors | string | Note: Condition descriptors are currently only available for the following trading card categories:
: ; | ) are not encoded. You must decode each name, and value or values separately. You cannot decode the entire string.The name and value are numeric IDs that map to the name and value, respectively, of a condition descriptor. A condition descriptor name-value pair provides more information about an item's condition in a structured way. Descriptors are name-value attributes that can be either from a closed set or open text. For more information on the numeric IDs and their text equivalents, use the getItemConditionPolicies method of the Metadata API. Occurrence: Conditional | ||||||||||||
items.sellerUserId | string | The unique identifier for an eBay user across all eBay sites. This value does not change, even when a user changes their username. Occurrence: Conditional |
HTTP status codes
This call can return one of the following HTTP status codes. For an overview of the status codes, see HTTP status codes in Using eBay RESTful APIs.
Status | Meaning |
---|---|
200 | Success |
204 | No Content This code is returned when there are no items that meet the criteria for this feed file. See Feed File Filters for details. |
206 | Partial Content |
400 | Bad request |
403 | Forbidden |
404 | Not found |
416 | Range not satisfiable |
500 | Internal server error |
Error codes
For more on errors, plus the codes of other common errors, see Handling errors.
Code | Domain | Category | Meaning |
---|---|---|---|
13000 | API_FEED | REQUEST | The request contains data that is invalid. Correct the request and submit the call again. For help, see the API Reference documentation for this call. |
13004 | API_FEED | REQUEST | The 'category_id' {category_id} submitted is invalid. See the API documentation for help on how to find category IDs. |
13006 | API_FEED | APPLICATION | There was a problem with an eBay internal system or process. Wait a few minutes and retry the call. If that doesn't work, contact eBay Support. |
13007 | API_FEED | REQUEST | The feed file requested cannot be found. It is possible the file requested is in the process of being generated. Either change the date or try the call again later. |
13010 | API_FEED | REQUEST | The mandatory 'category_id' query parameter is missing. |
13012 | API_FEED | REQUEST | The marketplace Id {marketplaceId} is invalid. Valid values: {allowedMarketplaces} |
13013 | API_FEED | REQUEST | The mandatory 'X-EBAY-C-MARKETPLACE-ID' header is missing. Valid values: {allowedMarketplaces} |
13014 | API_FEED | REQUEST | The marketplace Id {marketplaceId} is not supported. Valid values: {allowedMarketplaces} |
13015 | API_FEED | REQUEST | The mandatory 'Range' request header is missing. For help, see the API Reference documentation for this call. |
13016 | API_FEED | REQUEST | The 'Range' request header format is invalid. Format: 'bytes=start position-end position'. For help, see the API Reference documentation for this call. |
13017 | API_FEED | REQUEST | The 'Range' header is invalid. Please verify that the start and end positions are correct. For help, see the API Reference documentation for this call. |
13018 | API_FEED | REQUEST | The start position in the range header is invalid. |
13019 | API_FEED | REQUEST | The end position in the range header is invalid. |
13020 | API_FEED | REQUEST | The mandatory 'snapshot_date' query parameter is missing. |
13021 | API_FEED | REQUEST | The 'snapshot_date' query parameter is invalid.Valid format is 'yyyy-MM-ddTHH:mm:ss' |
13022 | API_FEED | REQUEST | The 'category_id' {category_id} submitted is not supported. |
13023 | API_FEED | BUSINESS | Insufficient permissions to access this API for the marketplace {marketplaceId}. Please contact eBay Technical Support for further assistance. |
13024 | API_FEED | BUSINESS | Insufficient permissions to access this API for the category {category_id}. Please contact eBay Technical Support for further assistance. |
Warnings
This call has no warnings.
Samples
New to making API calls? Please see Making a Call.
Note: Identifiers, such as order IDs or user IDs, and personal data in these samples might be anonymized or may no longer be active on eBay. If necessary, substitute current, relevant eBay data in your requests.
Sample 1: Download an Hourly Changed Item Feed File
This sample returns a GZIP file with the items that have changed on August 30, 2018 between 8-9am UTC in the Cameras & Photo category. In this example, the size of the file being returned is 142MB (148897792 bytes) and the request Range header specifies to return the first 10MB (10485760 bytes).
Input
The inputs are category_id, and snapshot_date in UTC format
(yyyy-MM-ddThh:mm:ss.sssZ) based on GMT, URI parameters.
The request
parameters are:
Range bytes=0-10485760
and X-EBAY-C-MARKETPLACE-ID
EBAY_US
. For more information about using these headers,
see HTTP request headers.
GEThttps://api.ebay.com/buy/feed/v1_beta/item_snapshot?category_id=625&snapshot_date=2018-08-30T08:00:00.000z
Output
If the call is successful, the portion of the file specified by the Range header, is returned.
The call returns a 206 HTTP status and the Content-range bytes=0-10485760/148897792
response header.