Important
New shipment package stream endpoint is available

For large-scale scanning and synchronization flows, please prefer getShipmentPackagesStream.

HomeGuidesAPI ReferenceChangelogSupport Request
Guides

Product Filter - Approved Product v2

This service allows you to list your approved products in your Trendyol store.

  • You need to send "storeFrontCode" as Header Parameter.
  • In order to filter products in Romanian, Greek and Arabic language, you can add "Accept-Language" as Header Parameter.
    • ro is used for filtering in the Romanian language on the RO storefront
    • el is used for filtering in the Greek language on the GR storefront
    • ar is used for filtering in the Arabic language on the SA, AE and KW storefronts
    • If you want to receive the product information in English, you need to send it with "Accept-Language" as en.
  • The nextPageToken information has been added to requests made to this service.
    • If you send a request with request?page=10&size=100, the response will return 100 content items from the 10th page.
    • In your subsequent request, if you send request?size=100&nextPageToken=TOKEN, the response will return 100 content items from the next page (the 11th page).
    • The nextPageToken request is applicable when there are more than 10,000 approved content items.
    • The value of page multiplied by size cannot exceed 10,000.

GET filterProducts

Parameters

Parameter

Explanation

Data

barcode

The unique barcode must be submitted for verification.

string

startDate

It brings products from after a certain date. It must be sent as a timestamp.

long

endDate

It retrieves the previous date after a specific date. It must be submitted as a timestamp.

long

page

It only returns the information on the specified page.

int

dateQueryType

The date the date filter will work with can be sent as VARIANT_CREATED_DATE, VARIANT_MODIFIED_DATE, CONTENT_MODIFIED_DATE.

  • VARIANT_CREATED_DATE: variant created date by seller. It equals to “sellerCreatedDate” in the response body  
  • VARIANT_MODIFIED_DATE: variant created date by seller. It equals to “sellerModifiedDate” in the response body  
  • CONTENT_MODIFIED_DATE: content last modified date. It equals to “lastModifiedDate” in the response body

string

size

Specifies the maximum number of items that can be listed on a page. The maximum value can be 100.

int

supplierId

The supplier's ID information must be submitted.

long

stockCode

The relevant supplier's stock code information must be submitted.

string

productMainId

The relevant supplier's productMainId information must be submitted.

string

brandIds

It should be used to list products with the specified brand ID.

array

status

The Status field can accept the values ​​"archived", "blacklisted", "locked", "onSale", and "notOnSale".

string

nextPageToken

It should be used to purchase products after the first 10,000 units.

string

contentId

The unique contentId must be submitted for filtering

string

orderByDirection

"SellerCreatedDate" field can be used to sort by ASC/DESC.
ASC: Sorts from old to new.
DESC: Sorts from new to old.

string

Sample Service Response


{
    "totalElements": 1,
    "totalPages": 1,
    "page": 0,
    "size": 20,
    "nextPageToken": "eyJzb3J0IjpbMTI3MTU4MTVdfQ==",
    "content": [
        {
            "contentId": 12715815,
            "productMainId": "12613876842A60",
            "brand": {
                "id": 315675,
                "name": "GUEYA"
            },
            "category": {
                "id": 91266,
                "name": "DOKUNMAYIN Attribute Attribute"
            },
            "creationDate": 1760531038063,
            "lastModifiedDate": 1760938781669,
            "lastModifiedBy": "[email protected]",
            "title": "Açık Gri T-",
            "description": "değişti değişti2",
            "images": [
                {
                    "url": "/mediacenter-stage3/stage/QC_PREP/20250731/11/f63d6503-ab94-3567-adbc-8f26a5cdaac6/1.jpg"
                }
            ],
            "attributes": [
                {
                    "attributeId": 47,
                    "attributeName": "Renk",
                    "attributeValue": "Black"
                },
                {
                    "attributeId": 295,
                    "attributeName": "Web Color",
                    "attributeValueId": 2886,
                    "attributeValue": "Kırmızı"
                },
                {
                    "attributeId": 294,
                    "attributeName": "Yaş Grubu",
                    "attributeValueId": 2879,
                    "attributeValue": "Yetişkin"
                },
                {
                    "attributeId": 296,
                    "attributeName": "Cinsiyet",
                    "attributeValueId": 2873,
                    "attributeValue": "Erkek"
                }
            ],
            "variants": [
                {
                    "variantId": 70228905,
                    "supplierId": 2748,
                    "barcode": "12613876842A60",
                    "attributes": [
                        {
                            "attributeId": 293,
                            "attributeName": "Beden",
                            "attributeValueId": 4602,
                            "attributeValue": "77 x 200 cm"
                        }
                    ],
                    "productUrl": "https://stage.trendyol.com/abc/xyz-p-12715815?&merchantId=2748&filterOverPriceListings=false",
                    "onSale": false,
                    "deliveryOptions": {
                        "deliveryDuration": 1,
                        "isRushDelivery": true,
                        "fastDeliveryOptions": [
                            {
                                "deliveryOptionType": "SAME_DAY_SHIPPING",
                                "deliveryDailyCutOffHour": "15:00"
                            }
                        ]
                    },
                    "stock": {
                        "quantity": 0,
                        "lastModifiedDate": 1774948958844
                    },
                    "price": {
                        "salePrice": 222,
                        "listPrice": 222
                    },
                    "stockCode": "STK-stokum-1",
                    "vatRate": 0,
                    "sellerCreatedDate": 1760534152000,
                    "sellerModifiedDate": 1761041127000,
                    "locked": false,
                    "lockReason": null,
                    "lockDate": null,
                    "archived": false,
                    "archivedDate": null,
                    "docNeeded": false,
                    "hasViolation": false,
                    "blacklisted": false
                },
                {
                    "variantId": 70229505,
                    "supplierId": 2748,
                    "barcode": "12613876842A61",
                    "attributes": [
                        {
                            "attributeId": 293,
                            "attributeName": "Beden",
                            "attributeValueId": 4603,
                            "attributeValue": "77 x 300 cm"
                        }
                    ],
                    "productUrl": "https://stage.trendyol.com/abc/xyz-p-12715815?&merchantId=2748&filterOverPriceListings=false",
                    "onSale": false,
                    "deliveryOptions": {
                        "deliveryDuration": 1,
                        "isRushDelivery": true,
                        "fastDeliveryOptions": [
                            {
                                "deliveryOptionType": "SAME_DAY_SHIPPING",
                                "deliveryDailyCutOffHour": "15:00"
                            }
                        ]
                    },
                    "stock": {
                      "lastModifiedDate": null,
                      "quantity": 0,
                    },
                    "price": {
                        "salePrice": 222,
                        "listPrice": 222
                    },
                    "stockCode": "STK-stokum-1",
                    "vatRate": 0,
                    "sellerCreatedDate": 1760534320000,
                    "sellerModifiedDate": 1761041127000,
                    "locked": false,
                    "lockReason": null,
                    "lockDate": null,
                    "archived": false,
                    "archivedDate": null,
                    "docNeeded": false,
                    "hasViolation": false,
                    "blacklisted": false,
                    "sgrPrice": 3
                }
            ]
        }
    ]