---
title: "Get categories"
method: GET
path: "/vinted/categories"
tags: ["Vinted"]
---

# Get categories

`GET /vinted/categories`

## Request

- Base URL: `https://scrappa.co/api`
- URL: `https://scrappa.co/api/vinted/categories`
- Auth: API key in header `X-API-KEY`

Get all available catalog categories with their subcategories.
Use the returned catalog IDs with the search endpoint's catalog_ids parameter to filter items.

## Query parameters

- `country` 'FR' | 'DE' | 'ES' | 'IT' | 'NL' | 'BE' | 'AT' | 'PL' | 'CZ' | 'LT' | 'LU' | 'SK' | 'HU' | 'RO' | 'PT' | 'SE' | 'DK' | 'FI' | 'US' | 'null', nullable

## Response `200`

- object
  - `success` boolean, required
  - `data` object, required
    - `catalogs` object[], required
      - `id` integer, required
      - `title` string, required
      - `slug` string, required
      - `url` string, required
      - `is_visible` boolean, required
      - `is_root` boolean, required
      - `parent_id` integer, nullable, required
      - `children` unknown[], required
        - unknown
  - `message` string, required
  - `meta` object, required
    - `duration_ms` number, required
    - `scraped_at` string, required
    - `cached` boolean

## Other responses

- `401`: Unauthorized - API key is missing or invalid
- `422`: Invalid country code provided
- `500`: Failed to fetch categories from Vinted or parse response

---

[API](https://skmtc.dev/scrappa/apis/scrappa-api-documentation.md) · [All operations](https://skmtc.dev/scrappa/apis/scrappa-api-documentation/llms.txt) · [OpenAPI document](https://skmtc.dev/scrappa/apis/scrappa-api-documentation/revisions/1e1aa78ff103?raw)