[NEWS] Udostępniliśmy nowy zasób, dzięki któremu sprawdzisz sugerowane kategorie dla podanej frazy / We have introduced a new resource that allows you to retrieve the suggested categories for the given phrase

Udostępniliśmy dziś nowy zasób [GET /sale/matching-categories](https://developer.allegro.pl/documentation/#operation/categorySuggestionUsingGET), za pomocą którego po podaniu frazy pobierzesz sugerowaną listę kategorii, w których możesz wystawić swój przedmiot. Dzięki temu łatwiej i szybciej zidentyfikujesz odpowiednią kategorię.

W żądaniu przekaż parametr **name**, w którym podaj wyszukiwaną frazę, np. **name=bmw x3**. W odpowiedzi otrzymasz listę sugerowanych kategorii.

**Przykładowy request:**

```
curl -X GET \
'https://api.allegro.pl/sale/matching-categories?name=bmw x3' \
-H 'Authorization: Bearer {token}' \
-H 'Accept: application/vnd.allegro.public.v1+json'
```

**Przykładowy response:**

```
{
"matching_categories": [
{
"id": "250885", -- identyfikator sugerowanej kategorii,
"name": "Wahacze", -- nazwa sugerowanej kategorii
"parent": { -- kategoria nadrzędna w stosunku do
sugerowanej kategorii:
dzięki tej strukturze poznasz dokładną
ścieżkę sugerowanej kategorii,
"id": "250882", -- identyfikator kategorii nadrzędnej,
"name": "Wahacze i elementy", -- nazwa kategorii nadrzędnej,
"parent": {
"id": "8683",
"name": "Układ zawieszenia",
"parent": {
"id": "620",
"name": "Części samochodowe",
"parent": {
"id": "3",
"name": "Motoryzacja",
"parent": null
}
}
}
}
},
….
{
"id": "255100",
"name": "Lampy przeciwmgielne",
"parent": {
"id": "255098",
"name": "Lampy przednie i elementy",
"parent": {
"id": "623",
"name": "Oświetlenie",
"parent": {
"id": "620",
"name": "Części samochodowe",
"parent": {
"id": "3",
"name": "Motoryzacja",
"parent": null
}
}
}
}
}
]
}

```

-----

Today we have introduced a new resource [GET /sale/matching-categories](https://developer.allegro.pl/en/documentation/#operation/categorySuggestionUsingGET) that allows you to retrieve the suggested categories in which you can list your product from the given phrase. Owing to this you can easier and faster identify the appropriate category.

In the request, pass the **name** parameter in which you will provide the searched phrase, e.g. **name = bwm x3**. In response, you will receive a list of suggested categories.

**Sample request:**

```
curl -X GET \
'https://api.allegro.pl/sale/matching-categories?name=bmw x3' \
-H 'Authorization: Bearer {token}' \
-H 'Accept: application/vnd.allegro.public.v1+json'
```

**Sample response:**

```
{
"matching_categories": [
{
"id": "250885", -- id of the suggested category,
"name": "Wahacze", -- name of the suggested category,
"parent": { -- parent category in relation to the
suggested category: owing to this
object you will know the exact
suggested category path
"id": "250882", -- id of the parent category
"name": "Wahacze i elementy", -- name of the parent category
"parent": {
"id": "8683",
"name": "Układ zawieszenia",
"parent": {
"id": "620",
"name": "Części samochodowe",
"parent": {
"id": "3",
"name": "Motoryzacja",
"parent": null
}
}
}
}
},
….
{
"id": "255100",
"name": "Lampy przeciwmgielne",
"parent": {
"id": "255098",
"name": "Lampy przednie i elementy",
"parent": {
"id": "623",
"name": "Oświetlenie",
"parent": {
"id": "620",
"name": "Części samochodowe",
"parent": {
"id": "3",
"name": "Motoryzacja",
"parent": null
}
}
}
}
}
]
}
```