---
title: "List local businesses"
method: GET
path: "/dimensions/local_businesses"
tags: ["Shopping & Ads"]
---

# List local businesses

`GET /dimensions/local_businesses`

## Request

- Base URL: `https://api.llmpulse.ai/api/v1`
- URL: `https://api.llmpulse.ai/api/v1/dimensions/local_businesses`
- Auth: API key in header `Authorization`

Local businesses (shops, restaurants, services) listed inside AI answers, one row per business: its name at its address, so two locations of a chain are two rows. Each row carries its appearance count, the number of prompts that listed it, its average rating and average position in the list, its review count, and whether it is yours or a tracked competitor. Every response also carries a totals block matching the KPI cards in the app. Local business lists come from a subset of models and only for prompts with local intent. Available on every plan.

## Query parameters

- `project_id` integer, required
- `page` integer
- `per_page` integer
- `owned` boolean
- `order` 'appearances' | 'business' | 'rating' | 'reviews' | 'avg_position' | 'prompts'
- `direction` 'asc' | 'desc'
- `query` string
- `model` 'chatgpt' | 'perplexity' | 'ai_mode' | 'ai_overview' | 'gemini' | 'copilot' | 'amazon_rufus' | 'claude' | 'grok' | 'deepseek' | 'naver_ai' | 'baidu_ai' | 'meta_ai' | 'naver_ai_tab' | 'qwen' | 'doubao'
- `collection_id` string
- `country_code` string
- `language_code` string
- `prompt` integer
- `prompt_type` string
- `brand_kind` 'brand' | 'brand_other' | 'non_brand'
- `range` integer
- `from` string, date-time
- `to` string, date-time
- `output` 'flat' | 'csv'

## Response `200`

Paginated local business rows plus totals

- LocalBusinessesResponse
  - `project_id` integer
  - `page` integer
  - `per_page` integer
  - `total` integer
  - `totals` LocalBusinessesTotals
    - `businesses` integer
    - `your_businesses` integer
    - `appearances` integer
    - `avg_rating` number, nullable
    - `executions_with_local_businesses` integer
  - `data` LocalBusiness[]
    - `business_key` string: Stable grouping key: the lowercased name and address
    - `title` string
    - `address` string, nullable
    - `domain` string, nullable
    - `url` string, nullable
    - `phone` string, nullable
    - `avg_rating` number, nullable
    - `reviews` integer, nullable
    - `avg_position` number, nullable: Average rank of the business in the answer's list (1 = first)
    - `prompts` integer
    - `appearances` integer
    - `is_client` boolean
    - `competitor_id` integer, nullable
    - `competitor_name` string, nullable
  - `request_id` string

## Other responses

- `422`: Invalid parameters

## Changes

- **2026-10-04** `770ae6720799`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/llmpulse/apis/llm-pulse-api/changes/dimensions/local_businesses/get.md)

---

[API](https://skmtc.dev/llmpulse/apis/llm-pulse-api.md) - [All operations](https://skmtc.dev/llmpulse/apis/llm-pulse-api/llms.txt) - [OpenAPI document](https://skmtc.dev/llmpulse/apis/llm-pulse-api/revisions/38a31f123641?raw)