Just getting started with the Sell Feed API? See the following documents for details on using this API:

Announcements

See the API Site Status for announcements regarding recently resolved or current system wide issues. Visit the Developer Support page for support options and information on filing bugs.

The API release history

The following table lists the releases for the Feed API:

Version Release Date Summary of Release

v1.3.1

2022-10-27

This API release aligns inventory_task reference documentation with existing filter criteria functionality and adds an error to the uploadFile method.

v1.3.0 2021-04-26 This API release contains the following updates:
  • Seller Hub and LMS feed types are supported
  • New inventory_task resource
  • Updated FeedStatusEnum type with new enumeration value
v1.2.0 2020-11-13 This API release contains two updates:
  • New Schedule API capabilities
  • Upload summary returned for upload feeds
v1.1.0 2020-08-05 Release of customer_service_metric_task resources
v1.0.1 2020-07-09 Documentation and other updates
v1.0.0 2020-05-20 Initial release

v1.3.1

This API release contains the following updates.

Reference document update for inventory_task resource

The following fields were removed from the createInventoryTask reference documentation because they were never supported by the API:

  • creationDateRange

  • modifiedDateRange

  • listingStatus

  • inventoryFileTemplate

In addition, the InventoryFilterCriteria type was modified and two other types were removed:

  • ListingStatusEnum

  • InventoryFileTemplateEnum

Added new error ID to uploadFile method

Added the following errorId to the uploadFile method:

160100: "Payload not found. Make sure your file is uploaded inside the Request Body under the key name 'file'.

v1.3.0

This API release contains the following updates.

File Exchange and LMS feed types are supported

This release supports File Exchange and Large Merchant Services (LMS) feed types:

New inventory_task resource

This release of the Sell Feed API introduces the inventory_task resource, which includes the following new methods:

  • createInventoryTask – This method creates an inventory-related upload or download task for a specified feed type.
  • getInventoryTask – This method retrieves the details and status of an inventory-related task based on the task ID.
  • getInventoryTasks – This method retrieves the details and statuses of multiple inventory-related tasks based on feed type, schedule ID, or other optional URI parameters.

To support these new methods, the following types were added: 

  • CreateInventoryTaskRequest
  • InventoryFileTemplateEnum
  • InventoryFilterCriteria
  • InventoryTask
  • InventoryTaskCollection
  • ListingFormatEnum
  • ListingStatusEnum

Updated FeedStatusEnum type

This release of the Sell Feed API adds a new enumeration value to the FeedStatusEnum type. The new enumeration value, PARTIALLY_PROCESSED, indicates that a task has failed to complete, but was partially processed.

Tip: Refer to the Sell Feed API reference documentation to view a full list of supported enumeration values for the FeedStatusEnum type.

v1.2.0

This API release contains the following updates.

New Schedule API capabilities

This release provides scheduling capabilities to the feed API resource. These capabilities generate reports periodically for a specified feedType as described by the template used to create the schedule. To support this feature, the schedule resource was added that includes the following methods and their associated fields and values:

  • createSchedule
  • deleteSchedule
  • getLatestResultFile
  • getSchedule
  • getSchedules
  • getScheduleTemplate
  • getScheduleTemplates
  • updateSchedule

Resources to support the new scheduling capabilities were also added to the following methods:

  • getTasks: added schedule_id parameter
  • getOrderTasks: added schedule_id parameter

New upload summary returned for upload feeds

This release provides summary information for upload feeds. To support this feature, the following fields were added to the getOrder, getOrders, getOrderTask, and getOrderTasks methods:

  • uploadSummary container field for:
    • failureCount: The number of records that failed to process during the upload feed.
    • successCount: The number of records that were successfully processed during the upload feed.

v1.1.0

This release of the Sell Feed API includes the following addition:

  • customer_service_metric_task resources

v1.0.1

This release of the Sell Feed API includes changes to the documentation and other updates for the following resources:

  • order_task resources:
    • Corrections to grant types
    • Added new HTTP status code to createOrderTask method: 409 Conflict
    • Updates to errorId: 160002, 160022, 160024, 1600025
    • Removal of errorId: 160005, 160007
    • Updates to response examples for getOrderTask and getOrderTasks methods
  • task resources:
    • Correction to grant type for getTask
    • Added new HTTP status code to createTask method: 409 Conflict
    • Updates to errorId: 160002, 160003, 160014, 160015, 160022, 160024, 1600025
    • Removal of errorId: 160005, 160007
    • Updates to response examples for getTask and getTasks methods

v1.0.0

This is the initial release of the Sell Feed API and includes the following resources:

  • order_task

  • task

  • customer_service_metric_task (coming soon)