---
title: "List all Target categories"
method: GET
path: "/target/categories"
tags: ["Target"]
---

# List all Target categories

`GET /target/categories`

## Request

- Base URL: `https://api.crawlora.net/api/v1`
- URL: `https://api.crawlora.net/api/v1/target/categories`
- Auth: API key in header `x-api-key`

Lists Target's top-level category menu in `categories`, plus the grouped shop-all directory in `groups`. Each category has an `id` (the one used by `/target/category-products`), name, canonical URL and, when Target supplies one, an image URL. The response also gives `count` and `group_count`. Takes no parameters.

## Headers

- `x-api-key` string, required

## Response `200`

OK

- TargetCategoriesResponseDoc
  - `code` integer
  - `data` TargetCategoriesResponse
    - `categories` TargetCategory[]
      - `id` string
      - `image_url` string
      - `name` string
      - `url` string
    - `count` integer
    - `fetched_at` string
    - `group_count` integer
    - `groups` TargetCategoryGroup[]
      - `categories` TargetCategory[]
        - `id` string
        - `image_url` string
        - `name` string
        - `url` string
      - `name` string
    - `source_url` string
  - `msg` string

## Other responses

- `429`: Too Many Requests
- `503`: Service Unavailable

---

[API](https://skmtc.dev/crawlora/apis/crawlora-api.md) · [All operations](https://skmtc.dev/crawlora/apis/crawlora-api/llms.txt) · [OpenAPI document](https://skmtc.dev/crawlora/apis/crawlora-api/revisions/0497899e2016?raw)
