Słownik: lokalizacje (`getLocalizations`)

GET/api/rank_tracker/dictionary/project/getLocalizations

Zwraca listę lokalizacji (miasta, dzielnice, regiony) pasujących do frazy name w danym kraju — do konfiguracji lokalnego monitoringu pozycji (śledzenie wyników dla konkretnej lokalizacji). Każdy wiersz zawiera id (do użycia przy tworzeniu projektu), type, kanoniczną nazwę oraz nazwę zlokalizowaną.

ID lokalizacji	Typ	Nazwa kanoniczna	ID kraju	Nazwa (lokalna)	Locale
21991	City	Warsaw,Masovian Voivodeship,Poland	1	Warszawa, województwo mazowieckie, Polska	pl_PL

country_id 1, name „Wars”. Wszystkie pola wiersza.

Żądanie

GET /api/rank_tracker/dictionary/project/getLocalizations

Nagłówki: Authorization: Bearer <token>. Parametry w query stringu.


curl --location --request GET 'https://api.senuto.com/api/rank_tracker/dictionary/project/getLocalizations?country_id=1&name=Wars' \
  --header 'Authorization: Bearer $YOUR_TOKEN_HERE'

Parametry

Name	Type	Default
`country_id`	`number` ID kraju (bazy). Wymagany `country_id` lub `region_id` — bez żadnego z nich zwracana jest pusta lista.
`name`	`string` Fragment nazwy lokalizacji do dopasowania (np. `Wars`). Opcjonalny.
`region_id`	`number` ID regionu (zawężenie). Opcjonalny.

Warunek where budowany jest z country_id/region_id — jeśli żadnego nie podasz, zapytanie zwróci pustą listę. Podaj co najmniej country_id.

Odpowiedź

data to lista lokalizacji.

Name	Type	Default
`success`	`boolean`
`data`	`{ id: number; type: string; canonical: string; country_id: number; name: string; _locale: string; }[]`

Błędy

Błędy tego endpointu przychodzą we wspólnej kopercie ze statusem 418.

Powiązane akcje

countries/getList — słownik krajów; id stąd podajesz jako country_id w tym endpoincie
projects/getListWithExtendedData — projekty wraz z ustawioną lokalizacją
projects/getProjectFits — tryby dopasowania projektu
positions/getData — pozycje fraz w projekcie, także dla monitoringu lokalnego

Słownik: lokalizacje (getLocalizations)