Udostępniliśmy dziś nowy zasób GET /sale/matching-categories, 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 i podaj w nim 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
            }
          }
        }
      }
    }
  ]
}