[GET] - Company Search

Use the Company Search resource to fetch a list of companies. The elements in the companies list contain an id value and enough additional information such that a user could narrow down the selection from the list. Using the selected id values you can retrieve additional company information through the Company Details endpoint.

Endpoint

GET https://api.insideview.com/api/v1/companies

Request

HTTP Headers

Header Name	Type	Required	Description
accessToken	String	Yes	Valid access token. See Authentication and Authorization Overview for more details.
Accept	String	No	Selects the response's content type.   Valid values are application/json and application/xml (default).

Query Parameters

Parameter Name	Type	Required	Description
name	String	Yes1	Company name
website	String	Yes1	Corporate website
ticker	String	Yes1	Stock market abbreviation
country	String	No	Country name (e.g. United States, France)
state	String	No
city	String	No
street	String	No
zip	String	No
page	Integer	No	The page number of the result-set to return. Default: 1
resultsPerPage	Integer	No	The number of results in a page request. Min: 1, Max: 50, Default: 10

1: the request should include at least one of the three mandatory parameters.

Responses

HTTP 200

Returns either a JSON or XML data structure depending on the request Accept header. 

Name	type	Description
companies	Array	Array of search results
companies > companyId	Integer	InsideView Company ID
companies > name	String	Company name
companies > city	String	Company address: city
companies > state	String	Company address: state
companies > country	String	Company address: country
page	Integer	Page number in the result set
resultsPerPage	Integer	Number of search result per page
totalResults	Integer	Total number of search results

application/json example

{
  "companies": [
    {
      "id": 736233,
      "name": "Google, Inc.",
      "city": "Mountain View",
      "state": "CA",
      "country": "United States"
    },
    {
      "id": 2546544,
      "name": "AdMob Google Inc.",
      "city": "Mountain View",
      "state": "CA",
      "country": "United States"
    },
    {
      "id": 1416385,
      "name": "Google UK Limited",
      "city": "London",
      "state": "",
      "country": "United Kingdom"
    },
    {
      "id": 1475170,
      "name": "Google Ireland Limited",
      "city": "Dublin",
      "country": "Ireland"
    },
    {
      "id": 1739593,
      "name": "Google Affiliate Network Inc.",
      "city": "",
      "country": "United States"
    },
    {
      "id": 1750717,
      "name": "Google India Private Limited",
      "city": "Bengaluru",
      "country": "India"
    },
    {
      "id": 1456802,
      "name": "Google Australia Pty. Ltd.",
      "city": "Sydney",
      "state": "New South Wales",
      "country": "Australia"
    },
    {
      "id": 2725793,
      "name": "Google Canada Corporation",
      "city": "Halifax",
      "state": "NS",
      "country": "Canada"
    },
    {
      "id": 3221568,
      "name": "Google Germany GmbH",
      "city": "Hamburg",
      "country": "Germany"
    },
    {
      "id": 3221567,
      "name": "Google Brasil Internet Ltda.",
      "city": "Sao Paulo",
      "state": "São Paulo",
      "country": "Brazil"
    }
  ],
  "page": 1,
  "resultsPerPage": 10,
  "totalResults": 58
}
    

application/xml example

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<companies>
  <company>
    <city>Mountain View</city>
    <country>United States</country>
    <id>736233</id>
    <name>Google, Inc.</name>
    <state>CA</state>
  </company>
  <company>
    <city>Mountain View</city>
    <country>United States</country>
    <id>2546544</id>
    <name>AdMob Google Inc.</name>
    <state>CA</state>
  </company>
  <company>
    <city>London</city>
    <country>United Kingdom</country>
    <id>1416385</id>
    <name>Google UK Limited</name>
    <state />
  </company>
  <company>
    <city>Dublin</city>
    <country>Ireland</country>
    <id>1475170</id>
    <name>Google Ireland Limited</name>
  </company>
  <company>
    <city />
    <country>United States</country>
    <id>1739593</id>
    <name>Google Affiliate Network Inc.</name>
  </company>
  <company>
    <city>Bengaluru</city>
    <country>India</country>
    <id>1750717</id>
    <name>Google India Private Limited</name>
  </company>
  <company>
    <city>Sydney</city>
    <country>Australia</country>
    <id>1456802</id>
    <name>Google Australia Pty. Ltd.</name>
    <state>New South Wales</state>
  </company>
  <company>
    <city>Halifax</city>
    <country>Canada</country>
    <id>2725793</id>
    <name>Google Canada Corporation</name>
    <state>NS</state>
  </company>
  <company>
    <city>Hamburg</city>
    <country>Germany</country>
    <id>3221568</id>
    <name>Google Germany GmbH</name>
  </company>
  <company>
    <city>Sao Paulo</city>
    <country>Brazil</country>
    <id>3221567</id>
    <name>Google Brasil Internet Ltda.</name>
    <state>São Paulo</state>
  </company>
  <page>1</page>
  <resultsPerPage>10</resultsPerPage>
  <totalResults>58</totalResults>
</companies>

HTTP 400

Invalid query parameter(s).

HTTP 401

Unauthorized Error - Cannot use API's without setting a valid accessToken in header.

HTTP 405

Method Not Allowed - Your are not allowed to access this API.

HTTP 429

Request is throttled.