---
title: "Get keyword data"
method: GET
path: "/v1/keywords/{keywordId}"
tags: ["Keywords"]
---

# Get keyword data

`GET /v1/keywords/{keywordId}`

## Request

- Base URL: `https://llmrefs.com/api`
- URL: `https://llmrefs.com/api/v1/keywords/{keywordId}`
- Auth: HTTP bearer

Returns the detailed breakdown of the keyword's AI SEO analytics data for the current period.

## Path parameters

- `keywordId` string, required: Keyword ID

## Query parameters

- `organizationId` string, required: Organization ID
- `projectId` string, required: Project ID
- `searchEngines` string: Filter by AI search engines (comma separated list)

## Response `200`

Successful response

- object
  - `id` string, required
  - `value` string, required
  - `location` string, required
  - `searchVolume` number, nullable, required
  - `rankings` object[], required
    - `rank` number, required
    - `brandId` string, required
    - `shareOfVoice` string, required
    - `averagePosition` string, required
  - `sources` object[], required
    - `source` string, required
    - `mentionRate` string, required
  - `responses` object[], required
    - `prompt` string, required
    - `searchEngine` string, required
    - `text` string, required
    - `brandsIds` string[], required
    - `sources` string[], required
  - `brands` object[], required
    - `id` string, required
    - `name` string, required
    - `domain` string, nullable, required

---

[API](https://skmtc.dev/llmrefs/apis/llmrefs-ai-seo-api.md) - [All operations](https://skmtc.dev/llmrefs/apis/llmrefs-ai-seo-api/llms.txt) - [OpenAPI document](https://skmtc.dev/llmrefs/apis/llmrefs-ai-seo-api/revisions/949134eaa440?raw)