---
title: "List Keywords"
method: GET
path: "/locations/{locationId}/keywords"
tags: ["Rankings", "Keywords"]
---

# List Keywords

`GET /locations/{locationId}/keywords`

## Request

- Base URL: `https://api.synup.com/api/v4`
- URL: `https://api.synup.com/api/v4/locations/{locationId}/keywords`
- Auth: none required
- TypeScript: <https://skmtc.dev/synup/apis/synup-api/docs/locations/:locationId/keywords/get.ts> (a function with typed inputs; its response is checked against the schema)

This API retrieves all keywords associated with a specific location.

**Behavior:**
- Returns a complete list of keywords linked to the location.
- Includes unique keyword IDs and names.

## Path parameters

- `locationId` string, required

## Headers

- `Authorization` string, required

## Response `200`

Successfully retrieved keywords

- object
  - `data` object
    - `keywordsByLocationId` KeywordV3[]: List of keywords associated with the location. Returns empty array if no keywords exist.
      - `id` string, required: The unique ID attached to the keyword
      - `name` string, required: The text value of the keyword

## Other responses

- `400`: Invalid location ID
- `401`: Unauthorized access

---

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