product-barcode-api

Searches for products by barcode or name; returns a minimum of 1 and a maximum of 10 products. Billing per call: Credits: metered (~0.84 avg).

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "title": "search",
      "example": "Çikolatalı Gofret",
      "default": "Çikolatalı Gofret",
      "description": "It allows the user to specify the name or barcode of the product they wish to search for. Using this parameter, the system searches for products based on name or barcode matches and returns the results."
    },
    "marketPrices": {
      "type": "string",
      "title": "marketPrices",
      "example": "false",
      "default": "false",
      "description": "This setting controls whether price information for the requested products at stores is retrieved. If set to `true`, the product's store prices are also returned; if set to `false` or left unspecified, only the product's basic information is retrieved. If data is available, +1 credit is consumed for every 10 market price data points."
    },
    "preferredMarkets": {
      "type": "string",
      "title": "preferredMarkets",
      "example": "A101,Hakmar",
      "default": "A101,Migros",
      "description": "It allows the user to specify the preferred markets for which they wish to view product prices. When this parameter is provided, price information is returned only for the listed markets within the `markets` field. If the parameter is not provided, price information for all markets is displayed. Users can specify multiple markets by separating them with commas (e.g., `preferredMarkets=A101,Migros`). If data is available, 1 credit is consumed for every 10 market-price data points."
    },
    "historyPrices": {
      "type": "string",
      "title": "historyPrices",
      "example": "false",
      "default": "false",
      "description": "Adds historical price information for the requested product from available markets to the response. The `marketPrices` parameter must be set to `true`. If historical price information is available, 1 credit is consumed."
    }
  },
  "required": [
    "query"
  ],
  "additionalProperties": false
}

Lists products using pagination. Billing per call: Credits: metered (~207.29 avg).

{
  "type": "object",
  "properties": {
    "page": {
      "type": "string",
      "title": "page",
      "example": "0",
      "default": "0",
      "description": "Page number (default: 0)"
    },
    "size": {
      "type": "string",
      "title": "size",
      "example": "20",
      "default": "20",
      "description": "Page size (default: 10, maximum: 100). It returns a number of products equal to the page size and consumes credits based on the number of products returned."
    },
    "marketPrices": {
      "type": "string",
      "title": "marketPrices",
      "example": "false",
      "default": "false",
      "description": "This setting controls whether price information for the requested products at stores is retrieved. If set to `true`, the product's store prices are also returned; if set to `false` or left unspecified, only the product's basic information is retrieved. If data is available, +1 credit is consumed for every 10 market price data points."
    },
    "preferredMarkets": {
      "type": "string",
      "title": "preferredMarkets",
      "example": "A101,Şok Market",
      "default": "A101,Migros",
      "description": "It allows the user to specify the preferred markets for which they wish to view product prices. When this parameter is provided, price information is returned only for the listed markets within the `markets` field. If the parameter is not provided, price information for all markets is displayed. Users can specify multiple markets by separating them with commas (e.g., `preferredMarkets=A101,Migros`). If data is available, 1 credit is consumed for every 10 market-price data points."
    },
    "historyPrices": {
      "type": "string",
      "title": "historyPrices",
      "example": "true",
      "default": "false",
      "description": "Adds historical price information for the requested product from available markets to the response. The `marketPrices` parameter must be set to `true`. If historical price information is available, 1 credit is consumed."
    }
  },
  "additionalProperties": false
}

Retrieves the 20 most recently updated products along with their market prices. Billing per call: 0 Credits.

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

It returns the current price and details of the product based on the specified barcode and store name. Price history can also be included optionally. Billing per call: Credits: metered (~0 avg).

{
  "type": "object",
  "properties": {
    "barcode": {
      "type": "string",
      "title": "barcode",
      "example": "8690767671081",
      "default": "8690767671081",
      "description": "The product's GTIN/EAN barcode number"
    },
    "marketName": {
      "type": "string",
      "title": "marketName",
      "example": "Migros",
      "default": "Migros",
      "description": "Name of the store where the price will be checked (e.g., Özdilekteyim, Migros)"
    },
    "history": {
      "type": "string",
      "title": "history",
      "example": "false",
      "default": "false",
      "description": "Returns historical price information; this is optional. If historical price information is available, it consumes 1 additional credit."
    },
    "isExist": {
      "type": "string",
      "title": "isExist",
      "example": "false",
      "default": "false",
      "description": "Is the relevant barcode available at the corresponding store? It does not use up credit."
    }
  },
  "required": [
    "barcode",
    "marketName"
  ],
  "additionalProperties": false
}

Retrieves the market names used in the filters. Billing per call: 0 Credits.

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

It retrieves the product's historical price information for the relevant store. Billing per call: 1 Credits.

{
  "type": "object",
  "properties": {
    "barcode": {
      "type": "string",
      "title": "barcode",
      "example": "8699141059286",
      "default": "8690767671081",
      "description": "The product's GTIN/EAN barcode number"
    },
    "market": {
      "type": "string",
      "title": "market",
      "example": "Migros",
      "default": "Migros",
      "description": "The market where the product's price history is recorded. It must exist within the system."
    }
  },
  "required": [
    "barcode"
  ],
  "additionalProperties": false
}

Ürünleri Excel Formatında Mail Adresine İletir. Bu end-point'e yalnızca '$350/ay' planında erişilebilir. Billing per call: 1 Credits.

{
  "type": "object",
  "properties": {
    "size": {
      "type": "string",
      "title": "size",
      "example": "100",
      "description": "size parametresi, döndürülecek ürün sayısının maksimum değerini belirler. Eğer belirtilmezse varsayılan olarak 100 ürün döndürülür."
    },
    "marketPrices": {
      "type": "string",
      "title": "marketPrices",
      "example": "true",
      "description": "marketPrices parametresi, aranan ürünlerin marketlerdeki fiyat bilgilerinin getirilip getirilmemesini kontrol eder. Eğer true olarak gönderilirse, ürünün market fiyatları da döndürülür; false veya belirtilmezse yalnızca ürünün temel bilgileri getirilir. Yani bu parametre, fiyat bilgisinin isteğe bağlı olarak eklenip eklenmeyeceğini belirler."
    },
    "preferredMarkets": {
      "type": "string",
      "title": "preferredMarkets",
      "example": "A101,Şok Market",
      "description": "Kullanıcının aradığı ürünlerin fiyatlarını görmek istediği tercih ettiği marketleri belirtmesini sağlar. Eğer bu parametre verilirse, sadece listede belirtilen marketlerden gelen fiyat bilgileri markets alanında döndürülür. Parametre verilmezse, tüm marketlerin fiyat bilgileri gösterilir. Kullanıcı birden fazla market belirtmek isterse, bunları virgül (,) ile ayırarak gönderebilir; örneğin preferredMarkets=A101,Migros,Carrefour şeklinde"
    },
    "email": {
      "type": "string",
      "title": "email",
      "example": "[email protected]",
      "description": "email parametresi ise, üretilen Excel dosyasının veya CSV verisinin bir kopyasının istenirse bu e-posta adresine gönderilmesini sağlar. Parametre verilmezse dosya sadece API yanıtında döner, e-posta gönderimi yapılmaz."
    }
  },
  "additionalProperties": false
}

It returns the username and password for accessing the MySQL database containing product information. You can use this endpoint by subscribing to the $100 plan. Billing per call: 1 Credits.

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}