# Get keyword reports

A secured route for getting keyword reports

Endpoint: GET /api/v1/reports/keywords/accounts/{account_id}/campaigns/{campaign_id}
Version: 2.0.0
Security: JWTAuth

## Path parameters:

  - `account_id` (integer, required)
    Account ID of the requested account

  - `campaign_id` (integer, required)
    Campaign ID of the requested account

## Response 200 fields (application/json):

  - `data` (array)
    Example: [{"rank_google_organic":5,"rank_google_map":1,"rank_id":12344,"search_total":50,"histogram":[{"date":"2024-04-10T04:04:00","rank_google_organic":13},{"date":"2024-04-16T04:04:00","rank_google_map":1}],"keyword":"home improvements maryland","type":"target"}]

  - `data.rank_google_organic` (integer)
    Example: 5

  - `data.rank_id` (integer)
    Example: 13654

  - `data.rank_google_map` (integer)
    Example: 2

  - `data.search_total` (integer)
    Example: 564

  - `data.histogram` (array)

  - `data.histogram.date` (string)
    Example: "2024-04-10T04:04:00"

  - `data.keyword` (string)
    Example: "best hot sauce"

  - `data.type` (string)
    Example: "target"

  - `messages` (array)
    Example: []

  - `pagination` (object)
    Example: {"maxRows":0,"totalPages":1,"offset":0,"page":1,"totalRecords":0}

  - `pagination.totalPages` (integer)
    Example: 1

  - `pagination.maxRows` (integer)

  - `pagination.offset` (integer)

  - `pagination.page` (integer)
    Example: 1

  - `pagination.totalRecords` (integer)

  - `error` (boolean)

## Response 400 fields (application/json):

  - `data` (object, required)
    Example: {}

  - `error` (boolean, required)
    Example: true

  - `pagination` (object, required)
    Example: {"totalPages":1,"maxRows":0,"offset":0,"page":1,"totalRecords":0}

  - `pagination.totalPages` (integer)
    Example: 1

  - `pagination.maxRows` (integer)

  - `pagination.offset` (integer)

  - `pagination.page` (integer)
    Example: 1

  - `pagination.totalRecords` (integer)

  - `messages` (array, required)
    Example: ["Missing parameter"]

## Response 401 fields (application/json):

  - `data` (object, required)
    Example: {}

  - `error` (boolean, required)
    Example: true

  - `pagination` (object, required)
    Example: {"totalPages":1,"maxRows":0,"offset":0,"page":1,"totalRecords":0}

  - `pagination.totalPages` (integer)
    Example: 1

  - `pagination.maxRows` (integer)

  - `pagination.offset` (integer)

  - `pagination.page` (integer)
    Example: 1

  - `pagination.totalRecords` (integer)

  - `messages` (array, required)
    Example: ["Invalid Authorization"]

## Response 404 fields (application/json):

  - `data` (object, required)
    Example: {}

  - `error` (boolean, required)
    Example: true

  - `pagination` (object, required)
    Example: {"totalPages":1,"maxRows":0,"offset":0,"page":1,"totalRecords":0}

  - `pagination.totalPages` (integer)
    Example: 1

  - `pagination.maxRows` (integer)

  - `pagination.offset` (integer)

  - `pagination.page` (integer)
    Example: 1

  - `pagination.totalRecords` (integer)

  - `messages` (array, required)
    Example: ["Not Found"]

## Response 405 fields (application/json):

  - `data` (object, required)
    Example: {}

  - `error` (boolean, required)
    Example: true

  - `pagination` (object, required)
    Example: {"totalPages":1,"maxRows":0,"offset":0,"page":1,"totalRecords":0}

  - `pagination.totalPages` (integer)
    Example: 1

  - `pagination.maxRows` (integer)

  - `pagination.offset` (integer)

  - `pagination.page` (integer)
    Example: 1

  - `pagination.totalRecords` (integer)

  - `messages` (array, required)
    Example: ["Method Not Allowed"]