Important
New shipment package stream endpoint is available

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

HomeGuidesAPI ReferenceChangelogSupport Request
Guides

Product Filtering - Approved Products v2

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

  • Requests to this service now include a "nextPageToken". If you enter request?page=10&size=100 in your request, you will receive 100 content items from page 10 as a response. If you enter request?size=100&nextPageToken=TOKEN in your next request, you will receive 100 content items from page 11 as a response. (The "nextPageToken" request can be used if there are more than 10,000 approved content items.)

  • The maximum value for page x size is 10,000.

GET filterProducts

Parameters

Parametre

Explanation

Data

barcode

The unique barcode must be submitted for filtering.

string

startDate

Brings products from after a specific date. Must be sent as timestamps.

long

endDate

Brings products from before a specific date. Must be sent as timestamps.

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 obtain products after 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
                    },
                    "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
                }
            ]
        }
    ]
}