Localization

Each project has a localization: a country and a currency. DeepScout converts the prices of all websites in the project to this currency. Thus you can compare the prices of stores that sell in different currencies.

For example, the currency of your project is CZK. A German competitor sells a product for 19.99 EUR. The export of the competitor shows this price in CZK.

At this time, only the currency changes the data. The country and the locale do not change the exports.

In the console, the localization is the Market on Settings → Project.

FieldsCopy Anchor Link

GET /projects shows the localization of each project. A project without a localization has no localization field.

[
  {
    "project_id": "proj_01k7c2r9v8e3s0b1x6m4q5n2tz",
    "name": "Default project",
    "customer_id": "cust_01k7c2r9t2f8a5d3h7j9k1m6pw",
    "is_default": true,
    "localization": { "locale": "cs_CZ", "country": "cz", "currency": "CZK" }
  }
]

How a project gets its localizationCopy Anchor Link

• New project. POST /customers/{customer_id}/projects needs the localization. In the console, the New project dialog asks for the country and the currency.
• Default project. Your first sign-in creates the default project without a localization. The first website that you add to this project sets it. The project gets the country and the currency of the setup job. If the setup job fails, the project stays without a localization.

curl https://api.deepscout.ai/v1/customers/$CUSTOMER_ID/projects \
  -H "Authorization: Bearer $SCOUT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name": "Germany", "localization": {"country": "DE", "currency": "EUR"}}'

A project without a localization does not convert prices. Each website keeps the currency of its store. The currency field of each product shows it.

Change the localizationCopy Anchor Link

In the console:

1. Open Settings → Project.
2. In Market, select the country and the currency.
3. Click Save.

With the API, send PATCH /projects/{project_id}. You need the ADMIN role in the project.

curl -X PATCH https://api.deepscout.ai/v1/projects/$PROJECT_ID \
  -H "Authorization: Bearer $SCOUT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"localization": {"country": "AT", "currency": "EUR"}}'

{
  "project_id": "proj_01k7c2r9v8e3s0b1x6m4q5n2tz",
  "name": "Default project",
  "customer_id": "cust_01k7c2r9t2f8a5d3h7j9k1m6pw",
  "is_default": true,
  "localization": { "locale": "de_AT", "country": "at", "currency": "EUR" }
}

The API accepts the country and the currency in any letter case. An unknown country or currency gets 400 INVALID_LOCALE.

A change does not convert the current export files. The next completed scrape or matching writes all export files of the project again, in the new currency. See Know when new files are ready.

Currency conversionCopy Anchor Link

DeepScout uses the euro reference rates of the European Central Bank (ECB). The ECB publishes new rates on working days, at about 16:00 Central European Time. An export uses the latest rates at the time when the API writes the files.

The conversion changes these fields of the all_products_with_details dataset:

These prices do not change:

• The prices in the history records. They stay in the currency of the website.
• The sample data of a setup job. It shows the prices of the store.

DeepScout does not round the converted prices. Thus a converted price can have more decimal places than its currency uses, for example 485.9569 CZK.