API Reference

Öne Çıkan Teklif İçin Tahmini Fiyat Servisi

getFeaturedOfferExpectedPriceBatch servisi, birden fazla ürün (SKU) için Buy Box (Öne Çıkan Teklif) konumuna ulaşmak amacıyla önerilen tahmini fiyatları döner. Bu servis, satıcıların rekabeti daha iyi analiz etmelerine ve fiyatlarını Buy Box hedeflerine uygun şekilde ayarlamalarına yardımcı olur.

getFeaturedOfferExpectedPriceBatch Servisine İlişkin Notlar

  • En fazla 40 SKU için, ilgili pazaryerinde Buy Box’ta yer alabilmek adına önerilen fiyatı getirir.
  • Satıcı, bu verileri kullanarak fiyat optimizasyonu, karar destek sistemleri geliştirebilir.
  • Her SKU için fiyat tahmini döner.
  • POST methodu ile çalışır.
  • marketplaceId, uri, method & sku parametreleri zorunludur.
  • Başarılı Cevap 1 örneği üründe aktif teklif ve satın alma kutusu olan bir SKU üzerinden oluşturulmuştur. Başarılı Cevap 2 örneği ise istek atılan SKU'da teklif olmaması durumuna örnek olması amacıyla oluşturulmuştur.
  • request & response parametreleri detayına buradan ulaşabilirsiniz.

Örnek İstek

curl --location 'https://sellingpartnerapi-eu.amazon.com/batches/products/pricing/2022-05-01/offer/featuredOfferExpectedPrice' \
--header 'accept: application/json' \
--header 'Content-Type: application/json' \
--header 'x-amz-access-token: Atza|xxxxxxxxx' \
--data '{
  "requests": [
    {
      "method": "GET",
      "uri": "/products/pricing/2022-05-01/offer/featuredOfferExpectedPrice",
      "marketplaceId": "A33AVAJ2PDY3EV",
      "sku": "xxxxxxxxxxx"
    }
  ]
}
'
{
    "responses": [
        {
            "headers": {
                "x-amzn-RequestId": "700xxxxxxxxxx",
                "Date": "Wed, 13 Aug 2025 08:02:27 GMT"
            },
            "status": {
                "statusCode": 200,
                "reasonPhrase": "OK"
            },
            "body": {
                "featuredOfferExpectedPriceResults": [
                    {
                        "featuredOfferExpectedPrice": {
                            "listingPrice": {
                                "currencyCode": "TRY",
                                "amount": 109.89
                            }
                        },
                        "resultStatus": "VALID_FOEP",
                        "currentFeaturedOffer": {
                            "condition": "New",
                            "price": {
                                "shippingPrice": {
                                    "currencyCode": "TRY",
                                    "amount": 0.0
                                },
                                "listingPrice": {
                                    "currencyCode": "TRY",
                                    "amount": 100.0
                                }
                            },
                            "offerIdentifier": {
                                "marketplaceId": "A33AVAJ2PDY3EV",
                                "asin": "xxxxxxxxxx",
                                "sellerId": "xxxxxxxxx",
                                "fulfillmentType": "MFN"
                            }
                        },
                        "competingFeaturedOffer": {
                            "condition": "New",
                            "price": {
                                "shippingPrice": {
                                    "currencyCode": "TRY",
                                    "amount": 0.0
                                },
                                "listingPrice": {
                                    "currencyCode": "TRY",
                                    "amount": 115.0
                                }
                            },
                            "offerIdentifier": {
                                "marketplaceId": "A33AVAJ2PDY3EV",
                                "asin": "xxxxxxxxx",
                                "sellerId": "xxxxxxxxxx",
                                "fulfillmentType": "AFN"
                            }
                        }
                    }
                ],
                "offerIdentifier": {
                    "marketplaceId": "A33AVAJ2PDY3EV",
                    "asin": "xxxxxxxxx",
                    "sellerId": "xxxxxxxxxx",
                    "sku": "xxxxxxxxxxxxxx"
                }
            },
            "request": {
                "marketplaceId": "A33AVAJ2PDY3EV",
                "sku": "xxxxxxxxxxxxxx"
            }
        }
    ]
}
{
    "responses": [
        {
            "headers": {
                "x-amzn-RequestId": "xxxxxxxxxxx",
                "Date": "Wed, 13 Aug 2025 08:06:12 GMT"
            },
            "status": {
                "statusCode": 200,
                "reasonPhrase": "OK"
            },
            "body": {
                "featuredOfferExpectedPriceResults": [
                    {
                        "resultStatus": "OFFER_NOT_FOUND"
                    }
                ],
                "offerIdentifier": {
                    "marketplaceId": "A33AVAJ2PDY3EV",
                    "asin": "xxxxxxxxxxxxx",
                    "sellerId": "xxxxxxxxxxx",
                    "sku": "xxxxxxxxxxxxx"
                }
            },
            "request": {
                "marketplaceId": "A33AVAJ2PDY3EV",
                "sku": "xxxxxxxxxxxxx"
            }
        }
    ]
}
{
    "responses": [
        {
            "headers": {
                "x-amzn-RequestId": "xxxxxxxxxxxxxxxxxxx",
                "Date": "Wed, 13 Aug 2025 08:07:12 GMT"
            },
            "status": {
                "statusCode": 400,
                "reasonPhrase": "Bad Request"
            },
            "body": {
                "errors": [
                    {
                        "message": "Requested SKU is invalid, unsupported, or does not exist: [xxxxxxxxxx].",
                        "details": "",
                        "code": "InvalidInput"
                    }
                ]
            },
            "request": {
                "marketplaceId": "A33AVAJ2PDY3EV",
                "sku": "xxxxxxx"
            }
        }
    ]


Doldurulması Gereken Güvenlik Parametreleri

Örnek isteği gönderip sonuç alabilmeniz için istek içerisinde bulunan ve aşağıda listesi verilen parametreleri doldurmanız gerekmektedir.

Güvenlik Parametreleri
{{access-token}}
{{security-token}}
{{request-date}}
{{authorization}}