Skip to main content

GET/feed_type/{feed_type_id}

Use the getFeedType method to obtain the details about a particular feed type to determine its applicability to your needs.

With the response, you can compare the eBay marketplaces and categories with the eBay marketplaces and categories that your application is enabled to access. By making these comparisons, you can avoid attempting to download feed files that you do not have access to.

Note: For a list of supported sites and other restrictions, see API Restrictions.

Input

Resource URI

GET https://api.ebay.com/buy/feed/v1/feed_type/{feed_type_id}

This method is not supported in Sandbox environment.

URI parameters

ParameterTypeDescription
feed_type_idstringThis path parameter specifies the unique identifier for the feed type to be used as a search filter.

Use the getFeedTypes method to identify available feed types.

Note: Refer to Supported feed types to learn more about the feed types supported by the Feed API.

Occurrence: Required

HTTP request headers

All requests made to eBay REST operations require you to provide the Authorization HTTP header for authentication authorization.

All other standard RESTful request headers are optional. For more information on standard RESTful request headers, see the HTTP request headers- opens rest request components page table.

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

This call has no response headers.

Response payload

Response fields

Output container/fieldTypeDescription
descriptionstring

A description of the feed type.

Occurrence: Always

feedTypeIdstring

The unique identifier of the feed type.

Note: Refer to Supported feed types for additional details.

Occurrence: Always

supportedFeedsarray of SupportedFeed

An array of the feed files of the indicated feed type that are available to be downloaded.

Occurrence: Always

supportedFeeds.authorizationScopesarray of string

The oauth authorization scopes which grant access to the feed files.

Currently the only applicable authorization scope is https://api.ebay.com/oauth/api_scope/buy.item.feed.

Note: You can view your application's oauth scopes on the Application Keys page.

Occurrence: Always

supportedFeeds.constraintConstraint

This container shows the eBay marketplaces that support the corresponding feed type. If no constraints are returned, all marketplaces are supported.

Occurrence: Conditional

supportedFeeds.constraint.marketplaceIdsarray of MarketplaceIdEnum

A list of the marketplaces to which the application is constrained within the feed type.

Example: A value of EBAY_US means the application is constrained to the U.S. marketplace for the listed feed.

Note: The Buy Feed API is not supported by all eBay marketplaces. See API restrictions for information about regional constraints.

Occurrence: Conditional

supportedFeeds.feedScopeFeedScopeEnum

Specifies the frequency with which the feed file is made available (HOURLY, DAILY, WEEKLY).

Currently only DAILY and HOURLY are supported.

Occurrence: Always

supportedFeeds.lookBackTimeDuration

How far back from the current time to limit the returned feed files. The returned feed files will be those generated between the current time and the look-back time.

Example: A value of 120 will limit the returned feed files to those generated in the past 2 hours (120 minutes). If 3 feed files have been generated in the past 2 hours, those 3 files will be returned. A feed file generated 4 hours earlier will not be returned.

Occurrence: Always

supportedFeeds.lookBack.unitTimeDurationUnitEnum

This enumeration value indicates the time unit used for the time period.

Occurrence: Always

supportedFeeds.lookBack.valueinteger

The number of units of time in the span.

Occurrence: Always

supportedFeeds.statusFeedStatusEnum

The status for this feed. One of ACTIVE, PAUSED, or DEPRECATED.

Occurrence: Always

supportedFeeds.supportedSchemasarray of SupportedSchema

An array of the supported Feed API schemas for this feed type.

Occurrence: Always

supportedFeeds.supportedSchemas.definitionstring

A list of the fields that will be returned in the feed file.

Note: Refer to Supported feed types to learn about the feed fields that are included in each supported feed type.

Occurrence: Always

supportedFeeds.supportedSchemas.deprecatedboolean

Indicates whether the schema is still functional or deprecated. One of either true or false.

Occurrence: Always

supportedFeeds.supportedSchemas.formatsarray of FormatEnum

An list of the available formats in which the schema can be downloaded. Currently only TSV (Tab Separated Values) is supported.

Occurrence: Always

supportedFeeds.supportedSchemas.schemaVersionstring

The version of the Feed API schema under which the feed type was created.

Example: 1.0.

Occurrence: Always

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.

StatusMeaning
200OK
403Forbidden
404Not Found
500Internal Server Error

Error codes

For more on errors, plus the codes of other common errors, see Handling errors.

CodeDomainCategoryMeaning
13006API_FEEDAPPLICATIONThere was a problem with an eBay internal system or process. Contact eBay developer support for assistance.
14000API_FEEDREQUESTInvalid feed type id.
14011API_FEEDREQUESTInsufficient permissions for the feed type. 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: Retrieving feedType details

This call provides a list of the feeds of a particular feedtype that are available to download.

Input

The feed_type_id of the feed type CURATED_ITEM_FEED is appended to the end of the URI.

GEThttps://api.ebay.com/buy/feed/v1/feed_type/CURATED_ITEM_FEED

Output

The returned curated item feed supports a single daily feed. The feed is limited to the Australian (EBAY_AU) and French (EBAY_FR) marketplaces (but all L1 categories within those markets are supported). The maximum time period that one can search back for this feed type (lookBack) is 10 days.

Note: The definition sample here is deliberately shortened for space. An typical definition would include many more fields than are listed here.

Got thoughts? Click the feedback button – your insights help us improve!