---
title: Get a Keyword
framework: Apple Ads Platform API
role: symbol
role_heading: Web Service Endpoint
platforms: [apple ads platform api 1.0+]
path: apple-ads-platform-api/get-keywords-_id_
---

# Get a Keyword

Retrieve a single keyword by its unique identifier.

## URL

GET https://api.ads.apple.com/v1/keywords/{id}

## Path Parameters

id:

## Header Parameters

X-Ap-Context:

## Response Codes

200 OK: 400 Bad Request: 401 Unauthorized: 403 Forbidden: 404 Not Found: 429 Too Many Requests: 500 Internal Server Error:

## Discussion

Discussion This endpoint retrieves a single keyword by its ID. The response includes all keyword fields plus displayStatus, which reflects the combined delivery state of the keyword, its ad group, and its campaign. Deleted keywords remain retrievable and only the query endpoint supports listing multiple records.  |   |   |   |   |  Payload Examples

## See Also

- [Create a Keyword](apple-ads-platform-api/post-keywords.md)
- [Query Keywords](apple-ads-platform-api/post-keywords-query.md)
- [Update a Keyword](apple-ads-platform-api/put-keywords-_id_.md)
- [Delete a Keyword](apple-ads-platform-api/delete-keywords-_id_.md)