Overview

Localization

Localize titles and convert prices with request headers.

Responses are localized per request. Send the headers below to choose a language and currency, and the API returns titles and prices for that locale. Each header falls back to the store's default when the requested value isn't one you've enabled, so a request never fails on an unsupported locale, it just serves the default. Requests are authenticated with your API key (see Authentication).

Headers

HeaderDescription
Accept-LanguageLanguage code for localized text such as product titles. Falls back to the store's default language when the requested language isn't enabled.
X-CurrencyThree-letter currency code for converted prices. Falls back to the store's default currency when the requested currency isn't enabled.

Example

curl https://admin.getaeolian.com/api/v1/products \
  -H "Authorization: Bearer pk_your_api_key" \
  -H "Accept-Language: fr" \
  -H "X-Currency: EUR"

Titles in the response come back in French and prices are converted to euros. Omit a header to receive the store's default for that dimension.