---
title: "GET /item_priority"
method: GET
path: "/item_priority"
tags: ["item_priority"]
---

# GET /item_priority

`GET /item_priority`

Using this method, you can download a TSV\_GZIP (tab separated value gzip) **Item Priority** feed file, which allows you to track changes (deltas) in the status of your priority items, such as when an item is added or removed from a campaign. The delta feed tracks the changes to the status of items within a category you specify in the input URI. You can also specify a specific date for the feed you want returned.

**Important:** You must consume the daily feeds (**Item**, **Item Group**) before consuming the **Item Priority** feed. This ensures that your inventory is up to date.

### **Downloading feed files**

**Note:** Filters are applied to the feed files. For details, see [Feed File Filters](/api-docs/buy/static/api-feed.html#feed-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.

Priority Item 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](#range-header) request header. The [Content-range](#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](/api-docs/buy/static/api-feed_beta.html#retrv-gzip).

In addition to the API, there is an open source [Feed SDK](https://github.com/eBay/FeedSDK) written in Java that downloads, combines files into a single file when needed, and unzips the entire feed file. It also lets you specify field filters to curate the items in the 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](/api-docs/buy/feed/overview.html#API).

## Query parameters

- `category_id` string, required
- `date` string, required

## Headers

- `Accept` string, required
- `X-EBAY-C-MARKETPLACE-ID` string, required
- `Range` string, required

## Response `200`

Partial Content

- ItemPriorityResponse
  - `itemDelta` ItemPriority[] — The container for the array of items returned by the <b>getItemPriorityFeed</b> method. The data in the file is tab separated and the first row is the header, which labels the columns and indicates the order of the values on each line. The header labels match the fields that are described in the <a href="/api-docs/buy/feed/resources/item/methods/getItemPriorityFeed#h3-response-fields">Response fields</a> section.
    - `changeMetadata` string — Status change indicator of the listing.<br><br><b>Values:</b> <ul><li><code>ADDED_TO_CAMPAIGN</code></li><li><code>REMOVED_FROM_CAMPAIGN</code></li><li><code>TRACKING_PAYLOAD_REFRESHED</code></li></ul><span class="tablenote"><b>Note:</b> When a listing is removed from the campaign, <b>PriorityListingPayload</b> will be empty.</span><br><br>When multiple status changes are returned for a listing, the <b>changeMetadata</b> value will be a pipe-separated string (e.g., <code>ADDED_TO_CAMPAIGN|TRACKING_PAYLOAD_REFRESHED</code>).<br ><br >To use the returned value, you will need to separate the string by pipe (|).
    - `itemId` string — The unique identifier of an item in eBay RESTful format. An example would be <code>v1|1********2|4********2</code>.
    - `priorityListingPayload` string — EPN (eBay Partner Network) publishers append this value to their affiliate tracking URL when using an EPN tracking link to track changes that occur to Priority Listing items. <br><br><b>Example:</b><code>_trkparms=ispr%3D1&amdata=enc%3AAQAFAAAAkB1DmsmXf%2BqZ%2BCEMGdebW6oR75GCMdBmc4MCQ%2FCEPqgKHbT0jdWhPwfY5LdUs6HTaP0eBlwKE7Smy2eDslewF7l3xjwWxjqwzNAnsYgxn2PiGkTKbiQSQytFUiymdtANpk1qOnBOoMGMK%2BWsji7jYlvySSs9o9s24TxD6RqWZpNrltzOU7mfnv3H40SZ3YESzg%3D%3D</code><br/><br>See <a href="https://developer.ebay.com/api-docs/buy/static/ref-epn-link.html">Creating an EPN Tracking Link</a> for information on EPN tracking links.

## Other responses

- `204` — No Content
- `206` — Partial Content
- `400` — Bad request
- `403` — Forbidden
- `404` — Not found
- `409` — Conflict
- `416` — Range not satisfiable
- `500` — Internal server error

---

[API](https://skmtc.net/ebay/apis/buy-feed.md) · [All operations](https://skmtc.net/ebay/apis/buy-feed/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ebay/buy-feed/versions/de3f4b3f2096/schema)