ItemEndDate and ItemStartDate filters format

I'm using ebay browse api .I ran into a strange error. The documentation specifies the following format for the item End Date and itemStartDate filters:
itemStartDate:[2018-11-14T07:47:48Z..2018-12-14T07:47:48Z]
I'm trying to use this filter on a request, in the response in warnings I get a message that the filter value is invalid, with the following value:
itemEndDate:[2023-05-03T00:47:48Z..2023-05-03T08:00:43Z]

This is what the percent-encoding line looks like:
itemEndDate%3A%5B2023-05-03T00%3A47%3A48Z..2023-05-03T08%3A00%3A43Z%5D

99kuli87

Posted 3 years ago·Last reply 1 year ago

2 comments

developer_support@ebay

3 years ago

0 View listings

Hi @99kuli87

itemStartDate and itemEndDate filters of Browse API returns the items scheduled to start and items scheduled to end within the specified date-time range.

The first date-time value is the start of the range and the second date-time value is the end of the range. The start and end range value are separated by two dots ('..').

It is possible to only use a start range value or only use an end range value.

If only specifying a start range value, the two dots ('..') are not needed and every listing ending after that is returned.
filter=itemEndDate:[2018-11-14T07:47:48Z]
If only specifying the end range value, the two dots ('..') are required before the end range value and every listing ending before that is returned.
filter=itemEndDate:[..2018-12-14T07:47:48Z]

absa554604

·1 year ago

This is my URL and i am getting invalid message as well:

https://api.ebay.com/buy/browse/v1/item_summary/search?q=iphone&limit=1&filter=itemEndDate:[2024-11-27T05:52:03.218Z]

{
  "warnings": [
    {
      "errorId": 12002,
      "domain": "API_BROWSE",
      "category": "REQUEST",
      "message": "The itemEndDate filter value is invalid. For the valid values, refer to the API call documentation.",
      "parameters": [
        {
          "name": "fieldName",
          "value": "itemEndDate"
        },
        {
          "name": "filterValue",
          "value": "[2024-11-27T05:52:03.218Z]"
        }
      ]
    }
  ],

Okay I found the mistake:
The itemEndDate filter is meant to find listings ending in the future. Since I provided a date/time that is be in the past (depending on processing time), eBay throws a warning indicating the filter value might be invalid.