# Get keywords

This GET request allows you to retrieve a specific object by providing the  as a path parameter. This unique identifier ensures that only one object is returned. If you want to retrieve all keywords associated with your reseller account, simply omit the  parameter

Endpoint: GET /api/v1/keywords/{rank_id}
Version: 2.0.0
Security: JWTAuth

## Path parameters:

  - `rank_id` (integer, required)
    The rank ID of the keyword
    Example: 22

## Response 200 fields (application/json):

  - `data` (object, required)
    Example: {"rank_google_organic":6,"campaign_id":23,"status":1,"rank_google_map":999,"account_id":7,"rank_id":22,"keyword":"dc modern furniture","type":"interest"}

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

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

  - `data.campaign_id` (integer)
    Example: 23

  - `data.account_id` (integer)
    Example: 7

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

  - `data.status` (integer)
    Enum: 0, 1

  - `data.keyword` (string)
    Example: "dc modern furniture"

  - `data.type` (string)
    Enum: "target", "interest"

  - `error` (boolean, required)

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

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

  - `pagination.maxRows` (integer)

  - `pagination.offset` (integer)

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

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

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

## 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)
    Example: 1

  - `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)
    Example: 1

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

## 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)
    Example: 1

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

## Response 422 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)
    Example: 1

  - `messages` (array, required)
    Example: ["Unprocessable Entity"]