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 and Arabic language, you can add "Accept-Language" as Header Parameter.
    • RO is used for filtering in the Romanian language on the RO storefront
    • AR is used for filtering in the Arabic language on the SA and AE 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

ParameterExplanationData
barcodeThe unique barcode must be submitted for verification.string
startDateIt brings products from after a certain date. It must be sent as a timestamp.long
endDateIt retrieves the previous date after a specific date. It must be submitted as a timestamp.long
pageIt only returns the information on the specified page.int
dateQueryTypeThe date the date filter will work with can be sent as VARIANT_CREATED_DATE, VARIANT_MODIFIED_DATE, CONTENT_MODIFIED_DATE.string
sizeSpecifies the maximum number of items that can be listed on a page. The maximum value can be 100.int
supplierIdThe supplier's ID information must be submitted.long
stockCodeThe relevant supplier's stock code information must be submitted.string
productMainIdThe relevant supplier's productMainId information must be submitted.string
brandIdsIt should be used to list products with the specified brand ID.array
statusThe Status field can accept the values ​​"archived", "blacklisted", "locked", "onSale", and "notOnSale".string
nextPageTokenIt should be used to purchase products after the first 10,000 units.string
contentIdThe unique contentId must be submitted for filteringstring

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": {
                        "lastModifiedDate": null
                    },
                    "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
                }
            ]
        }
    ]
}