---
title: "List Substack categories"
method: GET
path: "/substack/categories"
tags: ["Substack"]
---

# List Substack categories

`GET /substack/categories`

## Request

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

Returns every public Substack category, with the category id required by /substack/category. Ids span two spaces: 32 categories use a numeric id and one uses the string id `podcast`. Both are accepted by /substack/category.

## Headers

- `x-api-key` string, required

## Response `200`

OK

- SubstackCategoriesResponseDoc
  - `code` integer
  - `data` SubstackCategoriesResult
    - `categories` SubstackCategory[]
      - `emoji` string
      - `id` string
      - `in_category_listing` boolean: InCategoryListing is false for the one id the category listing rejects ("bestseller", which exists only as a leaderboard).
      - `in_leaderboard` boolean: InLeaderboard is true when /substack/leaderboard accepts this id.
      - `name` string
      - `slug` string
  - `msg` string

## Other responses

- `400`: Bad Request
- `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/028417aa35bb?raw)