---
title: "List keywords"
method: GET
path: "/api/keywords"
tags: ["Keywords"]
---

# List keywords

`GET /api/keywords`

## Request

- Base URL: `https://api.appskyline.com`
- URL: `https://api.appskyline.com/api/keywords`
- Auth: one of:
  - HTTP basic
  - API key in header `Authorization`

Lists the tracked keywords of your organization, optionally filtered by `appId`. Requires the `keywords:read` scope. For stable traversal, set `pagination=cursor`; the response becomes `{items, nextCursor}` and is ordered by `_id`. Pass `nextCursor` back as `cursor` until it is null. The default array response and offset pagination remain unchanged when cursor pagination is not requested.

## Query parameters

- `appId` string
- `pagination` 'cursor'
- `cursor` string
- `limit` integer
- `skip` integer
- `sortField` string
- `sortDirection` 'ASC' | 'DESC'
- `fields` string

## Response `200`

Array of keywords, or `{items, nextCursor}` in cursor mode

## Other responses

- `400`: Malformed cursor, or a sort incompatible with cursor pagination
- `401`: Missing or invalid credentials
- `403`: API key is missing the `keywords:read` scope
- `429`: API key rate limit exceeded

---

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