Categories (Keyword Groups)

GET v3/accounts/{accountId}/categories

Returns the list of an account's active keyord groups (fka categories).

For smart keyword groups this endpoint returns all current tracked keywords at the time of endpoint engagement.

For example:

[{
    "created": "2015-01-01T17:58:07.000Z",
    "trackedSearchIds": [123456],    
    "modified": "2015-01-01T17:58:07.000Z",    
    "name": "Foo"
}, {
    "created": "2015-01-01T17:58:07.000Z",    
    "trackedSearchIds": [789012, 34567],    
    "modified": "2015-06-21T23:25:34.000Z",    
    "name": "Bar"
}, { 
    "created": "2015-01-08T17:58:07.000Z",    
    "trackedSearchIds": [123456, 789012, 34567, 9999999],    
    "modified": "2015-08-01T12:00:00.000Z",    
    "name": "All Keywords Example"
}]

The response is a JSON-encoded array containing objects representing the account’s configured currently active keyword groups.  Each has the attributes:

created Date the keyword group was created.  All date values are in ISO8601 format.
trackedSearchIds
An array of the tracked keywords (active or inactive) that are members of that keyword group.
modified Most recent modify date of the keyword group. All date values are in ISO8601 format.
name The mechanism for identifying a keyword group.

Try this endpoint with the interactive documentation.