<!--
{
  "availability" : [
    "Search Ads: 5.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "Apple_Ads",
  "identifier" : "/documentation/apple_ads/Get-a-Targeting-Keyword-in-an-Ad-Group",
  "metadataVersion" : "0.1.0",
  "role" : "Web Service Endpoint",
  "symbol" : {
    "kind" : "Web Service Endpoint",
    "modules" : [
      "Apple Ads"
    ],
    "preciseIdentifier" : "rest:apple_ads:get:v5-campaigns-{}-adgroups-{}-targetingkeywords-{}"
  },
  "title" : "Get a Targeting Keyword in an Ad Group"
}
-->

# Get a Targeting Keyword in an Ad Group

Fetches a specific targeting keyword in an ad group.

## Discussion

To return a specific targeting keyword, use the associated `campaignId`, `adgroupId`, and `keywordId` in the URI. You can also use a partial fetch. For more information, see the Use a Partial Fetch section of [Using Apple Ads API Functionality](/documentation/Apple_Ads/using-apple-search-ads-api-functionality).

### Payload example: Get a targeting keyword in an ad group

**Request:**

```
GET https://api.searchads.apple.com/api/v5/campaigns/{campaignId}/adgroups/{adgroupId}/targetingkeywords/{keywordId}
```

**Response:**

```json
{  
  "id": 542370642,
  "adGroupId": 427916203,
  "text": "targeting keyword example 1",
  "status": "ACTIVE",
  "matchType": "BROAD",
  "bidAmount": {
    "amount": "100",
    "currency": "USD"
  },
  "modificationTime": "2025-04-08T20:48:28.206",
  "deleted": false
}
```

### Payload example: Get a targeting keyword in an ad group in a Maximize Conversions campaign

**Request:**

```
GET https://api.searchads.apple.com/api/v5/campaigns/{campaignId}/adgroups/{adgroupId}/targetingkeywords/{keywordId}
```

**Response:**

```json
{
  "id": 542370642,
  "campaignId": 585885088,
  "adGroupId": 542370539,
  "text": "food delivery",
  "status": "ACTIVE",
  "matchType": "BROAD",
  "bidAmount": {
    "amount": "0",
    "currency": "USD"
  }
  ...
}
```

---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)