---
title: "List Local Lead Categories"
method: GET
path: "/v3/local-leads/categories"
tags: ["Local Leads"]
---

# List Local Lead Categories

`GET /v3/local-leads/categories`

## Request

- Base URL: `https://api.leadmagic.io`
- URL: `https://api.leadmagic.io/v3/local-leads/categories`
- Auth: API key in header `X-API-Key`

The category names Local Leads Search uses, most common first, with the number of
listings in each. **Free** on every plan.

## Query parameters

- `country` string
- `category_group` string
- `q` string
- `limit` integer
- `offset` integer

## Response `200`

Categories with listing counts

- object
  - `results` object[], required
    - `category` string
    - `category_group` string
    - `places` integer: Listings in this category
  - `count` integer, required
  - `credits_consumed` number

## Other responses

- `400`: Bad Request - The request was malformed or contains invalid parameters. **Common causes:** - Missing required fields - Invalid field format (e.g., malformed email) - Invalid JSON syntax - Invalid parameter values
- `401`: Unauthorized - Authentication failed. **Common causes:** - Missing X-API-Key header - Invalid or expired API key - Malformed API key

## Changes

- **2026-11-12** `1ae235c25bcc`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/leadmagic/apis/leadmagic-api/changes/v3/local-leads/categories/get.md)

---

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