GET /v1/entity/search/who

HTTP Method: GET

Path: /v1/entity/search/what/bylocation

Authentication: API Key required

Description: Perform a national company name search for entities by a supplied search phrase.

Parameters:

parameter type description required
who  string The company name to be searched for e.g. starbucks yes
per_page integer The number of results to return per page. Default 10. no
page integer The page number of results to return. Default 1. no
country string The ISO country code of the country's entities to search e.g. ie for Eire yes
language string The ISO language code of the supplied 'what' e.g. en for English no

Pseudo Sample Response:

{
    "success": true,
    "msg": "ok",
    "data": {
        "total_rows": 265,
        "rows": [
              {
                "id": "<entity_id>",
                "doc" : { }
              },              {

"id": "<entity_id>", "doc" : { } },

.

.

.

]

}

}

where

  • total_rows is the number of rows in the data set
  • <entity_id> is the number that uniquely identifies each entity
  • each "doc" is an entity, as described in the /v1/entity API call.

Docs Navigation