Name: Türkiye Product Data API: Barcode Search for Market Prices
Brand: camgoz.net-1
SKU: api-camgoz.net-1-barcode-product
Availability: InStock
Author: API Market

Ferhat Camgöz

# 🛒 Get Product Data with Barcode API for Türkiye Markets

## Overview

The 🛒 Get Product Data with Barcode API for Türkiye Markets provides access to product details from various Turkish markets. Using a barcode or keyword, you can retrieve product information, including prices, names, images, and market availability.  The API facilitates comparison shopping, market analysis, and inventory management by providing comprehensive product data from the Turkish market.

## Features

*   **Product Search:** Search for products by barcode or keyword.
*   **Market Prices:**  Retrieve pricing data from different markets in Türkiye.
*   **Optional Market Filtering:** Filter product pricing data by preferred markets.
*   **Product Details:** Get product names, brands, categories, and image URLs.
*   **Pricing History:** Obtain historical price data for selected products.
*   **Paginated Results:** Efficiently retrieve large datasets using pagination.
*   **Up-to-date Data**: Retrieves the most recently updated product prices

## Use Cases

*   **E-commerce Price Comparison:**  Power a price comparison website or app for Turkish consumers, enabling them to find the best deals on products across different online and physical stores. This benefits retailers and consumers.

*   **Retail Inventory Management:**  Integrate product data into retail inventory management systems to automatically update pricing and product information, ensuring accurate stock levels and competitive pricing strategies.

*   **Market Research and Analysis:**  Utilize the API for market research to track product trends, pricing strategies, and market penetration of different products across various Turkish markets, benefiting consumer brands and market analysts.

*   **Mobile Shopping Assistant:** Create a mobile app that allows users to scan barcodes and instantly access product information, prices, and availability from local Turkish markets. This enhances the shopping experience.

*   **Food Service Menu Pricing**: Integrate product and pricing information into restaurant or catering service software to automatically calculate menu pricing based on the most recent market prices of ingredients, optimizing profitability.

## Visual Examples

The following are visual examples for product information retrieved using the API:

**Example of Product Image:**
![Example Product Image](https://file.camgoz.net/126c5f78-3552-43d4-bfd0-3a1fd328efde.jpeg)

**Example Product Output:**
```json
{
    "name": "Süt",
    "barcode": "8690000000001",
    "brand": "A Brand",
    "category": "Food",
    "imageUrl": "https://file.camgoz.net/126c5f78-3552-43d4-bfd0-3a1fd328efde.jpeg",
    "price": 25.99,
    "tax": 1.5,
    "taxRate": 0.06,
    "total": 27.49,
    "salesUnit": "litre",
    "marketCount": 2,
    "markets": [
        {
            "id": "a1b2c3d4-e5f6-7890-1234-567890abcdef",
            "name": "Süt",
            "price": 25.99,
            "priceModified": "2024-01-01T00:00:00.000Z",
            "market": "Migros",
            "sourceUrl": "https://example.com/migros/sut",
            "location": "Istanbul",
            "history": [
                {
                    "oldPrice": 24.99,
                    "newPrice": 25.99,
                    "date": "2023-12-31T00:00:00.000Z"
                }
            ]
        },
        {
            "id": "f1e2d3c4-b5a6-9870-5678-90abcdef1234",
            "name": "Süt",
            "price": 26.49,
            "priceModified": "2024-01-02T00:00:00.000Z",
            "market": "Carrefoursa",
            "sourceUrl": "https://example.com/carrefoursa/sut",
            "location": "Ankara",
            "history": [
                {
                    "oldPrice": 25.49,
                    "newPrice": 26.49,
                    "date": "2024-01-01T00:00:00.000Z"
                }
            ]
        }
    ]
}
```
## API Documentation

### Base URL

All API requests should be made to: `https://prod.api.market/api/v1/magicapi/barcode-product`

### Authentication

Authentication is handled via API key. Include your API key in the request header:

```
x-api-market-key: YOUR_API_MARKET_KEY
```

### Endpoints

#### `GET /api/v1/magicapi/barcode-product/api/external/search`

Searches for a product by keyword or barcode.

*   **Summary:** Search for products by keyword or barcode.
*   **Description:** Performs a product search based on a keyword or barcode. Returns up to 10 matching products. Market price data can optionally be included based on your plan. Each market price entry consumes additional credits.
*   **Operation ID:** `search`

**Parameters:**

| Name             | In     | Description                                                              | Required | Schema   | Example   |
| ---------------- | ------ | ------------------------------------------------------------------------ | -------- | -------- | --------- |
| `query`          | query  | Search keyword or barcode. Matches product name or barcode similarity. | true     | `string` | `süt`     |
| `marketPrices`   | query  | If true, market price listings are included. Requires a suitable plan. | false    | `boolean`| `false`   |
| `preferredMarkets` | query  | Optional list of markets. Filters returned price data.              | false    | `array`  | `["Migros", "Carrefoursa"]` |
| `historyPrices`   | query  | Optional price history. Adds historical price information to the selected product.              | false    | `boolean`  | `true` |

**Responses:**

| Code  | Description                       | Content                                            |
| ----- | --------------------------------- | -------------------------------------------------- |
| 200   | Search completed successfully      | `array[ProductExternalDto]`                        |
| 400   | Invalid search query or missing headers | `array[ProductExternalDto]`                        |
| 401   | Unauthorized or invalid API key  | `array[ProductExternalDto]`                        |
| 429   | Rate limit or credit quota exceeded | `array[ProductExternalDto]`                        |

**Example Request:**

```bash
curl -X GET "https://prod.api.market/api/v1/magicapi/barcode-product/api/external/search?query=süt&marketPrices=true&preferredMarkets=Migros,Carrefoursa&historyPrices=true" -H "x-api-market-key: YOUR_API_MARKET_KEY"
```

**Example Response:**

```json
[
  {
    "name": "Süt",
    "barcode": "8690000000001",
    "brand": "A Brand",
    "category": "Food",
    "imageUrl": "https://via.placeholder.com/150",
    "price": 25.99,
    "tax": 1.5,
    "taxRate": 0.06,
    "total": 27.49,
    "salesUnit": "litre",
    "marketCount": 2,
    "markets": [
      {
        "id": "a1b2c3d4-e5f6-7890-1234-567890abcdef",
        "name": "Süt",
        "price": 25.99,
        "priceModified": "2024-01-01T00:00:00.000Z",
        "market": "Migros",
        "sourceUrl": "https://example.com/migros/sut",
        "location": "Istanbul",
        "history": [
            {
                "oldPrice": 24.99,
                "newPrice": 25.99,
                "date": "2023-12-31T00:00:00.000Z"
            }
        ]
      },
      {
        "id": "f1e2d3c4-b5a6-9870-5678-90abcdef1234",
        "name": "Süt",
        "price": 26.49,
        "priceModified": "2024-01-02T00:00:00.000Z",
        "market": "Carrefoursa",
        "sourceUrl": "https://example.com/carrefoursa/sut",
        "location": "Ankara",
        "history": [
            {
                "oldPrice": 25.49,
                "newPrice": 26.49,
                "date": "2024-01-01T00:00:00.000Z"
            }
        ]
      }
    ]
  }
]
```

#### `GET /api/v1/magicapi/barcode-product/api/external/last`

Retrieves the most recently priced products.  No API key required. No credit consumption.

*   **Summary:** Retrieves the most recently priced products.
*   **Description:** Returns a list of products with the most recently updated prices.  Includes products with at least 4 market prices. Returns a maximum of 20 products. No API key is required and no credits are consumed.
*   **Operation ID:** `getLast`

**Responses:**

| Code | Description                     | Content |
| ---- | ------------------------------- | ------- |
| 200  | Product list returned successfully | `string` |

**Example Request:**

```bash
curl -X GET "https://prod.api.market/api/v1/magicapi/barcode-product/api/external/last" -H "x-api-market-key: YOUR_API_MARKET_KEY"
```

**Example Response:**

```json
[
  {
    "name": "Ekmek",
    "barcode": "8690000000002",
    "brand": "B Brand",
    "category": "Food",
    "imageUrl": "https://via.placeholder.com/150",
    "price": 8.50,
    "tax": 0.50,
    "taxRate": 0.06,
    "total": 9.00,
    "salesUnit": "adet",
    "marketCount": 5,
    "markets": [
      {
        "id": "c1d2e3f4-a5b6-8790-3456-7890abcdef12",
        "name": "Ekmek",
        "price": 8.50,
        "priceModified": "2024-01-03T00:00:00.000Z",
        "market": "Migros",
        "sourceUrl": "https://example.com/migros/ekmek",
        "location": "Istanbul",
        "history": []
      },
      {
        "id": "b1c2d3e4-f5a6-7690-5678-90abcdef1234",
        "name": "Ekmek",
        "price": 8.75,
        "priceModified": "2024-01-02T00:00:00.000Z",
        "market": "Carrefoursa",
        "sourceUrl": "https://example.com/carrefoursa/ekmek",
        "location": "Ankara",
        "history": []
      },
	  {
        "id": "01234567-89ab-cdef-0123-456789abcdef",
        "name": "Ekmek",
        "price": 9.00,
        "priceModified": "2024-01-04T00:00:00.000Z",
        "market": "Şok",
        "sourceUrl": "https://example.com/sok/ekmek",
        "location": "Izmir",
        "history": []
      },
      {
        "id": "fedcba98-7654-3210-fedc-ba9876543210",
        "name": "Ekmek",
        "price": 8.25,
        "priceModified": "2024-01-05T00:00:00.000Z",
        "market": "BİM",
        "sourceUrl": "https://example.com/bim/ekmek",
        "location": "Bursa",
        "history": []
      },
      {
        "id": "1a2b3c4d-5e6f-7890-1234-567890abcdef",
        "name": "Ekmek",
        "price": 9.25,
        "priceModified": "2024-01-06T00:00:00.000Z",
        "market": "A101",
        "sourceUrl": "https://example.com/a101/ekmek",
        "location": "Adana",
        "history": []
      }
    ]
  }
]
```

#### `GET /api/v1/magicapi/barcode-product/api/external/getProducts`

Retrieves product data with optional market price data, using pagination.

*   **Summary:** Retrieves products and optional market price data.
*   **Description:** Returns paginated product data. Market price data can optionally be included based on your plan. Retrieving market data consumes additional credits for each market entry.
*   **Operation ID:** `getProducts`

**Parameters:**

| Name             | In     | Description                                                               | Required | Schema    | Example   |
| ---------------- | ------ | ------------------------------------------------------------------------- | -------- | --------- | --------- |
| `page`           | query  | Page number (default: 0)                                                  | false    | `integer` | `0`       |
| `size`           | query  | Page size (default: 10, maximum: 100)                                     | false    | `integer` | `10`      |
| `marketPrices`   | query  | If true, market-based price list is returned for each product. Requires a suitable plan. | false    | `boolean` | `false`   |
| `historyPrices`   | query  | Optional price history. Adds historical price information to the selected product.              | false    | `boolean`  | `true` |
| `preferredMarkets` | query  | Optional list of markets. Only price data from the selected markets is returned. | false    | `array`   | `["Migros", "Carrefoursa"]` |

**Responses:**

| Code | Description             | Content                       |
| ---- | ----------------------- | ----------------------------- |
| 200  | Products retrieved successfully | `PageProductExternalDto`      |
| 400  | Invalid request or missing header | `PageProductExternalDto`      |
| 401  | Unauthorized or invalid API credentials | `PageProductExternalDto`      |
| 429  | Rate limit or credit limit exceeded | `PageProductExternalDto`      |

**Example Request:**

```bash
curl -X GET "https://prod.api.market/api/v1/magicapi/barcode-product/api/external/getProducts?page=0&size=10&marketPrices=true&preferredMarkets=Migros,Carrefoursa&historyPrices=true" -H "x-api-market-key: YOUR_API_MARKET_KEY"
```

**Example Response:**

```json
{
  "totalElements": 100,
  "totalPages": 10,
  "size": 10,
  "content": [
    {
      "name": "Süt",
      "barcode": "8690000000001",
      "brand": "A Brand",
      "category": "Food",
      "imageUrl": "https://via.placeholder.com/150",
      "price": 25.99,
      "tax": 1.5,
      "taxRate": 0.06,
      "total": 27.49,
      "salesUnit": "litre",
      "marketCount": 2,
      "markets": [
        {
          "id": "a1b2c3d4-e5f6-7890-1234-567890abcdef",
          "name": "Süt",
          "price": 25.99,
          "priceModified": "2024-01-01T00:00:00.000Z",
          "market": "Migros",
          "sourceUrl": "https://example.com/migros/sut",
          "location": "Istanbul",
          "history": [
            {
              "oldPrice": 24.99,
              "newPrice": 25.99,
              "date": "2023-12-31T00:00:00.000Z"
            }
          ]
        },
        {
          "id": "f1e2d3c4-b5a6-9870-5678-90abcdef1234",
          "name": "Süt",
          "price": 26.49,
          "priceModified": "2024-01-02T00:00:00.000Z",
          "market": "Carrefoursa",
          "sourceUrl": "https://example.com/carrefoursa/sut",
          "location": "Ankara",
          "history": [
            {
              "oldPrice": 25.49,
              "newPrice": 26.49,
              "date": "2024-01-01T00:00:00.000Z"
            }
          ]
        }
      ]
    }
  ],
  "number": 0,
  "pageable": {
    "offset": 0,
    "pageNumber": 0,
    "pageSize": 10,
    "paged": true,
    "sort": {
      "empty": true,
      "sorted": false,
      "unsorted": true
    },
    "unpaged": false
  },
  "sort": {
    "empty": true,
    "sorted": false,
    "unsorted": true
  },
  "first": true,
  "last": false,
  "numberOfElements": 10,
  "empty": false
}
```

## Status Codes

*   **200 OK:** Request successful.
*   **400 Bad Request:** Invalid input parameters or malformed request. Check your request parameters and ensure they conform to the API's requirements.
*   **401 Unauthorized:** Missing or invalid API key. Ensure that the `x-api-market-key` header is present and contains a valid API key.
*   **403 Forbidden:** Valid API key but insufficient permissions. Your API key may not have access to the requested resource or feature. Check your subscription plan.
*   **404 Not Found:** Resource not found. The requested resource does not exist. Double-check the endpoint URL.
*   **429 Too Many Requests:** Rate limit exceeded. You have exceeded the API's rate limit. See the Rate Limits section for details.
*   **500 Internal Server Error:** Server-side error. An unexpected error occurred on the server. Retry the request. If the problem persists, contact support.
*   **503 Service Unavailable:** Service temporarily unavailable. The service is temporarily unavailable. Retry the request after some time.

## Rate Limits

Please consult your API.market plan for specific rate limits. If you exceed the rate limit, you will receive a `429 Too Many Requests` error. Implement exponential backoff in your code to handle rate limits gracefully.

## Error Handling

The API returns errors in JSON format:

```json
{
  "error": {
    "code": "invalid_parameter",
    "message": "The parameter 'query' is required",
    "status": 400
  }
}
```

*   **`code`**: A machine-readable error code.
*   **`message`**: A human-readable error message.
*   **`status`**: The HTTP status code.

Common Errors:

*   `invalid_parameter`: An invalid parameter value was provided.
*   `missing_parameter`: A required parameter was not provided.
*   `unauthorized`: Invalid API key.
*   `rate_limit_exceeded`: Rate limit exceeded.

Recommended Retry Strategies:

*   For `429 Too Many Requests` errors, implement exponential backoff.
*   For `500 Internal Server Error` and `503 Service Unavailable` errors, retry the request after a short delay.

## Implementation Guide

### Example Code

```javascript
// JavaScript example
const apiKey = "YOUR_API_MARKET_KEY";
const baseUrl = "https://prod.api.market/api/v1/magicapi/barcode-product/api/external";

async function searchProducts(query) {
    try {
        const response = await fetch(`${baseUrl}/search?query=${query}`, {
            headers: {
                "x-api-market-key": apiKey
            }
        });

        if (!response.ok) {
            throw new Error(`HTTP error! status: ${response.status}`);
        }

        const data = await response.json();
        console.log(data);
        return data;
    } catch (error) {
        console.error("Could not fetch products:", error);
    }
}

// Example usage
searchProducts("süt");
```

```python
# Python example
import requests

API_KEY = "YOUR_API_MARKET_KEY"
BASE_URL = "https://prod.api.market/api/v1/magicapi/barcode-product/api/external"

def search_products(query):
    try:
        headers = {"x-api-market-key": API_KEY}
        response = requests.get(f"{BASE_URL}/search?query={query}", headers=headers)
        response.raise_for_status()  # Raise an exception for bad status codes
        data = response.json()
        print(data)
        return data
    except requests.exceptions.RequestException as e:
        print(f"Could not fetch products: {e}")

# Example usage
search_products("süt")
```

```bash
# cURL example
curl -X GET "https://prod.api.market/api/v1/magicapi/barcode-product/api/external/search?query=süt" -H "x-api-market-key: YOUR_API_MARKET_KEY"
```

### Performance Optimization

*   Use pagination to retrieve only the necessary data.
*   Cache frequently accessed data to reduce API calls.
*   Specify `preferredMarkets` to minimize the amount of data returned and reduce credit consumption.

## FAQ

**Q: How do I get an API key?**
A: You can obtain an API key by subscribing to a plan on API.market.

**Q: What happens if I exceed the rate limit?**
A: You will receive a `429 Too Many Requests` error. Implement exponential backoff to handle rate limits gracefully.

**Q: How accurate is the product data?**
A: The product data is sourced from various Turkish markets and is updated regularly. However, accuracy may vary.

**Q: What markets are supported?**
A: The API supports a wide range of Turkish markets. Refer to the documentation for a complete list.

## Contact Us

If you have any questions or need assistance, you can reach out to us through the embedded chat on the bottom right corner of the page or send an email to hello@api.market.
```

Access Türkiye market product data by barcode. Get names, prices, images. Optimize e-commerce & business with real-time insights.

Türkiye Product Data API: Barcode Search for Market Prices