---
title: "Słownik: lokalizacje (`getLocalizations`)"
source: https://docs.senuto.com/modules/rank_tracker/rt-dictionary-getLocalizations
api: GET /api/rank_tracker/dictionary/project/getLocalizations
---

# Słownik: lokalizacje (`getLocalizations`)

**`GET /api/rank_tracker/dictionary/project/getLocalizations`**

Przykładowe żądanie:

```json
{
  "country_id": 1,
  "name": "Wars"
}
```

Przykładowa odpowiedź:

```json
{
  "success": true,
  "data": [
    {
      "id": 21991,
      "type": "City",
      "canonical": "Warsaw,Masovian Voivodeship,Poland",
      "country_id": 1,
      "name": "Warszawa, województwo mazowieckie, Polska",
      "_locale": "pl_PL"
    }
  ]
}
```

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.

```bash
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

```ts
type DictionaryGetLocalizationsRequest = {
/** ID kraju (bazy). Wymagany `country_id` **lub** `region_id` — bez żadnego z nich zwracana jest pusta lista. */
country_id?: number;
/** Fragment nazwy lokalizacji do dopasowania (np. `Wars`). Opcjonalny. */
name?: string;
/** ID regionu (zawężenie). Opcjonalny. */
region_id?: number;
}
export default DictionaryGetLocalizationsRequest
```

> **Ostrzeżenie:**
> 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.

```ts
type DictionaryGetLocalizationsResponse = {
success: boolean;
data: Array<{
  id: number;
  /** np. City, Neighborhood, Borough, Region */
  type: string;
  /** Nazwa kanoniczna (ang.), np. `Warsaw,Masovian Voivodeship,Poland` */
  canonical: string;
  country_id: number;
  /** Nazwa zlokalizowana */
  name: string;
  _locale: string;
}>;
}
export default DictionaryGetLocalizationsResponse
```

## Błędy

Błędy tego endpointu przychodzą we [wspólnej kopercie ze statusem `418`](/types/errors).

## Powiązane akcje

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