[GET] - Company Auto Complete API

  • Updated

Use this endpoint to auto-complete Company names based on the search query. The query can also return popular contacts within the searched company.

Endpoint

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

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

Returns the auto-complete company & contact results for a given query.

Parameter Name Type Required Description
query String Yes Query String for Company and Contact autoComplete
entities String No Valid values are 'company', 'contact', Default is both
page String No Page for result set
resultsPerPage Integer No The number of results in a page request.
Min: 1, Max: 50, Default: 10

Responses

HTTP 200

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

Name type Description
companies name  String name of company based on query
companies companyType  String Company type (Private, Public, Subsidiary) 
companies industry   String Company industry 
companies subIndustry   String Company sub-industry 
companies city   String Company address: city 
companies state  String Company address: state 
companies country   String Company address: country
companies industryCode  String Company industry code 
companies subIndustryCode   String Company sub-industry code 
companies companyId   Integer Company's insideView ID
contacts companyId  Integer Contact's InsideView Company ID
contacts contactId  Integer Contact's InsideView ID
contacts titles  List List of titles (String)
contacts imageUrl  String Contact's image URL
contacts fullName  String Contact's full name 
contacts companyName  String Contact's company name
resultsPerPage  Integer Number of search result per page
totalCompanyResults  Integer Total number of companies in results page.
page  Integer Total number of pages.

businessStructure

 String

The organizational structure of a company (globalParent, uncategorized, subsidiary, group, independent) 

companyStatusV2

 String

Company status (operating, non-Operating, acquired, liquidating, outOfBusiness, unassigned) 

companyTypeV2

 String

Company type (public, private, government, organization, unknown)

 

Note: The company and employment results are sorted in descending order based on Company and Exec popularity respectively.

Type: application/json

Schema

{  
   "$schema":"http://json-schema.org/draft-04/schema#",
   "id":"/",
   "type":"object",
   "properties":{  
      "companies":{  
         "id":"companies",
         "type":"array",
         "items":{  
            "id":"0",
            "type":"object",
            "properties":{  
               "name":{  
                  "id":"name",
                  "type":"string"
               },
               "companyType":{  
                  "id":"companyType",
                  "type":"string"
               },
               "industry":{  
                  "id":"industry",
                  "type":"string"
               },
               "subIndustry":{  
                  "id":"subIndustry",
                  "type":"string"
               },
               "city":{  
                  "id":"city",
                  "type":"string"
               },
               "state":{  
                  "id":"state",
                  "type":"string"
               },
               "country":{  
                  "id":"country",
                  "type":"string"
               },
               "industryCode":{  
                  "id":"industryCode",
                  "type":"string"
               },
               "subIndustryCode":{  
                  "id":"subIndustryCode",
                  "type":"string"
               },
               "companyId":{  
                  "id":"companyId",
                  "type":"integer"
               }
            }
         },
         "additionalProperties":false
      },
      "contacts":{  
         "id":"contacts",
         "type":"array",
         "items":{  
            "id":"0",
            "type":"object",
            "properties":{  
               "contactId":{  
                  "id":"contactId",
                  "type":"integer"
               },
               "imageUrl":{  
                  "id":"imageUrl",
                  "type":"string"
               },
               "companyId":{  
                  "id":"companyId",
                  "type":"integer"
               },
               "companyName":{  
                  "id":"companyName",
                  "type":"string"
               },
               "fullName":{  
                  "id":"fullName",
                  "type":"string"
               },
               "titles":{  
                  "id":"titles",
                  "type":"array",
                  "items":{  
                     "id":"0",
                     "type":"string"
                  }
               }
            }
         },
         "additionalProperties":false
      },
      "resultsPerPage":{  
         "id":"resultsPerPage",
         "type":"string"
      }
   },
   "additionalProperties":false
}

Example

{
  "companies": [
    {
      "name": "AdMob Google Inc.",
      "companyType": "Private",
      "industry": "Computer Software",
      "subIndustry": "Advertising Industry Software",
      "city": "Mountain View",
      "state": "CA",
      "country": "United States",
      "industryCode": "7",
      "subIndustryCode": "7_21",
      "companyId": 2546544,
      "businessStructure": "Subsidiary",
      "companyTypeV2": "Private",
      "companyStatusV2": "Operating"
    },
    {
      "name": "Google UK Limited",
      "companyType": "Private",
      "industry": "Computer Software",
      "city": "London",
      "country": "United Kingdom",
      "industryCode": "7",
      "companyId": 1416385,
      "businessStructure": "Subsidiary",
      "companyTypeV2": "Private",
      "companyStatusV2": "Operating"
    },
    {
      "name": "Google Ireland Limited",
      "companyType": "Private",
      "industry": "Media",
      "subIndustry": "Internet Search and Navigation Services",
      "city": "Dublin",
      "state": "Co. Dublin",
      "country": "Ireland",
      "industryCode": "23",
      "subIndustryCode": "23_15",
      "companyId": 1475170,
      "businessStructure": "Subsidiary",
      "companyTypeV2": "Private",
      "companyStatusV2": "Operating"
    },
    {
      "name": "Google India Private Limited",
      "companyType": "Private",
      "industry": "Computer Software",
      "subIndustry": "Collaborative Software",
      "city": "Bengaluru",
      "state": "Karnataka",
      "country": "India",
      "industryCode": "7",
      "subIndustryCode": "7_13",
      "companyId": 1750717,
      "businessStructure": "Subsidiary",
      "companyTypeV2": "Private",
      "companyStatusV2": "Operating"
    },
    {
      "name": "Google Australia Pty. Ltd.",
      "companyType": "Private",
      "industry": "Corporate Services",
      "subIndustry": "Sales Promotion",
      "city": "Sydney",
      "state": "New South Wales",
      "country": "Australia",
      "industryCode": "11",
      "subIndustryCode": "11_41",
      "companyId": 1456802,
      "businessStructure": "Subsidiary",
      "companyTypeV2": "Private",
      "companyStatusV2": "Operating"
    },
    {
      "name": "Google Affiliate Network Inc.",
      "companyType": "Private",
      "industry": "Corporate Services",
      "subIndustry": "Direct Marketing",
      "country": "United States",
      "industryCode": "11",
      "subIndustryCode": "11_12",
      "companyId": 1739593,
      "businessStructure": "Subsidiary",
      "companyTypeV2": "Private",
      "companyStatusV2": "Operating"
    },
    {
      "name": "Google Germany GmbH",
      "companyType": "Private",
      "industry": "Corporate Services",
      "subIndustry": "Programming and Data Processing Services",
      "city": "Hamburg",
      "state": "Hamburg",
      "country": "Germany",
      "industryCode": "11",
      "subIndustryCode": "11_9",
      "companyId": 3221568,
      "businessStructure": "Subsidiary",
      "companyTypeV2": "Private",
      "companyStatusV2": "Operating"
    },
    {
      "name": "Google Canada Corporation",
      "companyType": "Private",
      "industry": "Computer Software",
      "city": "Halifax",
      "state": "NS",
      "country": "Canada",
      "industryCode": "7",
      "companyId": 2725793,
      "businessStructure": "Subsidiary",
      "companyTypeV2": "Private",
      "companyStatusV2": "Operating"
    },
    {
      "name": "Google Ventures",
      "companyType": "Private",
      "industry": "Financial Services",
      "subIndustry": "Venture Capital",
      "city": "Mountain View",
      "state": "CA",
      "country": "United States",
      "industryCode": "15",
      "subIndustryCode": "15_33",
      "companyId": 15183010,
      "businessStructure": "Subsidiary",
      "companyTypeV2": "Private",
      "companyStatusV2": "Operating"
    },
    {
      "name": "Google Brasil Internet Ltda.",
      "companyType": "Private",
      "industry": "Corporate Services",
      "subIndustry": "Marketing and Advertising",
      "city": "Sao Paulo",
      "state": "São Paulo",
      "country": "Brazil",
      "industryCode": "11",
      "subIndustryCode": "11_27",
      "companyId": 3221567,
      "businessStructure": "globalParent",
      "companyTypeV2": "Private",
      "companyStatusV2": "Operating"
    }
  ],
  "contacts": [
    {
      "contactId": 11309612,
      "imageUrl": "https://pbs.twimg.com/profile_images/718562527404277760/lj_E05oj_normal.jpg",
      "companyId": 1509601,
      "companyName": "Google Finland OY",
      "fullName": "Eric Schmidt",
      "titles": [
        "Executive Chairman"
      ]
    },
    {
      "contactId": 11309941,
      "imageUrl": "https://pbs.twimg.com/profile_images/2899831505/15ef99c6db782414042f6fa64f411405_normal.png",
      "companyId": 2531488,
      "companyName": "Google Earth",
      "fullName": "John V. Hanke",
      "titles": [
        "Chief Executive officer and Director"
      ]
    },
    {
      "contactId": 13932842,
      "imageUrl": "https://pbs.twimg.com/profile_images/2899831505/15ef99c6db782414042f6fa64f411405_normal.png",
      "companyId": 1509601,
      "companyName": "Google Finland OY",
      "fullName": "John V. Hanke",
      "titles": [
        "Varapääjohtaja, Tuotehallinta"
      ]
    },
    {
      "contactId": 7076214,
      "companyId": 1115342,
      "companyName": "Google Product Search",
      "fullName": "Marissa Mayer",
      "titles": [
        "Vice President"
      ]
    },
    {
      "contactId": 8156430,
      "companyId": 2546544,
      "companyName": "AdMob Google Inc.",
      "fullName": "Maynard George Webb",
      "titles": [
        "Director"
      ]
    },
    {
      "contactId": 11311948,
      "companyId": 1750717,
      "companyName": "Google India Private Limited",
      "fullName": "Patrick Pichette",
      "titles": [
        "Chief Financial Officer, Senior Vice President"
      ]
    },
    {
      "contactId": 89738305,
      "imageUrl": "https://pbs.twimg.com/profile_images/862522293846646785/k7QIo4SG_normal.jpg",
      "companyId": 7573216,
      "companyName": "Google Inc.",
      "fullName": "Kevin  Scott",
      "titles": [
        "Sr. Engineering Director"
      ]
    },
    {
      "contactId": 8218887,
      "imageUrl": "https://pbs.twimg.com/profile_images/862522293846646785/k7QIo4SG_normal.jpg",
      "companyId": 2546544,
      "companyName": "AdMob Google Inc.",
      "fullName": "Kevin  Scott",
      "titles": [
        "Vice President of Engineering"
      ]
    },
    {
      "contactId": 11309915,
      "imageUrl": "https://pbs.twimg.com/profile_images/684285437087735808/0hxon_fJ_normal.jpg",
      "companyId": 1509601,
      "companyName": "Google Finland OY",
      "fullName": "Sundar Pichai",
      "titles": [
        "Varapääjohtaja, Tuotehallinta"
      ]
    },
    {
      "contactId": 89642249,
      "imageUrl": "https://pbs.twimg.com/profile_images/603080824/me_too2_normal.jpg",
      "companyId": 7573216,
      "companyName": "Google Inc.",
      "fullName": "Mike Jennings",
      "titles": [
        "Program Manager"
      ]
    }
  ],
  "resultsPerPage": 10
}

Type: application/xml

Schema

<xs:schema attributeFormDefault="unqualified" elementFormDefault="qualified" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:element name="autoComplete">
    <xs:complexType>
      <xs:sequence>
        <xs:element name="companies">
          <xs:complexType>
            <xs:sequence>
              <xs:element name="company" maxOccurs="unbounded" minOccurs="0">
                <xs:complexType>
                  <xs:sequence>
                    <xs:element type="xs:int" name="companyId"/>
                    <xs:element type="xs:string" name="city" minOccurs="0"/>
                    <xs:element type="xs:string" name="companyType"/>
                    <xs:element type="xs:string" name="country"/>
                    <xs:element type="xs:string" name="industry"/>
                    <xs:element type="xs:string" name="industryCode"/>
                    <xs:element type="xs:string" name="name"/>
                    <xs:element type="xs:string" name="state" minOccurs="0"/>
                    <xs:element type="xs:string" name="subIndustry" minOccurs="0"/>
                    <xs:element type="xs:string" name="subIndustryCode" minOccurs="0"/>
                  </xs:sequence>
                </xs:complexType>
              </xs:element>
            </xs:sequence>
          </xs:complexType>
        </xs:element>
        <xs:element name="contacts">
          <xs:complexType>
            <xs:sequence>
              <xs:element name="contact" maxOccurs="unbounded" minOccurs="0">
                <xs:complexType>
                  <xs:sequence>
                    <xs:element name="titles">
                      <xs:complexType>
                        <xs:sequence>
                          <xs:element type="xs:string" name="title"/>
                        </xs:sequence>
                      </xs:complexType>
                    </xs:element>
                    <xs:element type="xs:int" name="companyId"/>
                    <xs:element type="xs:string" name="companyName"/>
                    <xs:element type="xs:int" name="contactId"/>
                    <xs:element type="xs:string" name="fullName"/>
                    <xs:element type="xs:string" name="imageUrl" minOccurs="0"/>
                  </xs:sequence>
                </xs:complexType>
              </xs:element>
            </xs:sequence>
          </xs:complexType>
        </xs:element>
        <xs:element type="xs:int" name="resultsPerPage"/>
      </xs:sequence>
    </xs:complexType>
  </xs:element>
</xs:schema>

Example

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<autoComplete>
    <companies>
        <company>
            <companyId>2546544</companyId>
            <sources/>
            <britishSics/>
            <city>Mountain View</city>
            <companyType>Private</companyType>
            <country>United States</country>
            <industry>Computer Software</industry>
            <industryCode>7</industryCode>
            <name>AdMob Google Inc.</name>
            <state>CA</state>
            <subIndustry>Advertising Industry Software</subIndustry>
            <subIndustryCode>7_21</subIndustryCode>
            <businessStructure>Subsidiary</businessStructure>
            <companyTypeV2>Private</companyTypeV2>
            <companyStatusV2>Operating</companyStatusV2>
        </company>
        <company>
            <companyId>1416385</companyId>
            <sources/>
            <britishSics/>
            <city>London</city>
            <companyType>Private</companyType>
            <country>United Kingdom</country>
            <industry>Computer Software</industry>
            <industryCode>7</industryCode>
            <name>Google UK Limited</name>
            <businessStructure>Subsidiary</businessStructure>
            <companyTypeV2>Private</companyTypeV2>
            <companyStatusV2>Operating</companyStatusV2>
        </company>
        <company>
            <companyId>1475170</companyId>
            <sources/>
            <britishSics/>
            <city>Dublin</city>
            <companyType>Private</companyType>
            <country>Ireland</country>
            <industry>Media</industry>
            <industryCode>23</industryCode>
            <name>Google Ireland Limited</name>
            <state>Co. Dublin</state>
            <subIndustry>Internet Search and Navigation Services</subIndustry>
            <subIndustryCode>23_15</subIndustryCode>
            <businessStructure>Subsidiary</businessStructure>
            <companyTypeV2>Private</companyTypeV2>
            <companyStatusV2>Operating</companyStatusV2>
        </company>
        <company>
            <companyId>1750717</companyId>
            <sources/>
            <britishSics/>
            <city>Bengaluru</city>
            <companyType>Private</companyType>
            <country>India</country>
            <industry>Computer Software</industry>
            <industryCode>7</industryCode>
            <name>Google India Private Limited</name>
            <state>Karnataka</state>
            <subIndustry>Collaborative Software</subIndustry>
            <subIndustryCode>7_13</subIndustryCode>
            <businessStructure>Subsidiary</businessStructure>
            <companyTypeV2>Private</companyTypeV2>
            <companyStatusV2>Operating</companyStatusV2>
        </company>
        <company>
            <companyId>1456802</companyId>
            <sources/>
            <britishSics/>
            <city>Sydney</city>
            <companyType>Private</companyType>
            <country>Australia</country>
            <industry>Corporate Services</industry>
            <industryCode>11</industryCode>
            <name>Google Australia Pty. Ltd.</name>
            <state>New South Wales</state>
            <subIndustry>Sales Promotion</subIndustry>
            <subIndustryCode>11_41</subIndustryCode>
            <businessStructure>Subsidiary</businessStructure>
            <companyTypeV2>Private</companyTypeV2>
            <companyStatusV2>Operating</companyStatusV2>
        </company>
        <company>
            <companyId>1739593</companyId>
            <sources/>
            <britishSics/>
            <companyType>Private</companyType>
            <country>United States</country>
            <industry>Corporate Services</industry>
            <industryCode>11</industryCode>
            <name>Google Affiliate Network Inc.</name>
            <subIndustry>Direct Marketing</subIndustry>
            <subIndustryCode>11_12</subIndustryCode>
            <businessStructure>Subsidiary</businessStructure>
            <companyTypeV2>Private</companyTypeV2>
            <companyStatusV2>Operating</companyStatusV2>
        </company>
        <company>
            <companyId>3221568</companyId>
            <sources/>
            <britishSics/>
            <city>Hamburg</city>
            <companyType>Private</companyType>
            <country>Germany</country>
            <industry>Corporate Services</industry>
            <industryCode>11</industryCode>
            <name>Google Germany GmbH</name>
            <state>Hamburg</state>
            <subIndustry>Programming and Data Processing Services</subIndustry>
            <subIndustryCode>11_9</subIndustryCode>
            <businessStructure>Subsidiary</businessStructure>
            <companyTypeV2>Private</companyTypeV2>
            <companyStatusV2>Operating</companyStatusV2>
        </company>
        <company>
            <companyId>2725793</companyId>
            <sources/>
            <britishSics/>
            <city>Halifax</city>
            <companyType>Private</companyType>
            <country>Canada</country>
            <industry>Computer Software</industry>
            <industryCode>7</industryCode>
            <name>Google Canada Corporation</name>
            <state>NS</state>
            <businessStructure>Subsidiary</businessStructure>
            <companyTypeV2>Private</companyTypeV2>
            <companyStatusV2>Operating</companyStatusV2>
        </company>
        <company>
            <companyId>15183010</companyId>
            <sources/>
            <britishSics/>
            <city>Mountain View</city>
            <companyType>Private</companyType>
            <country>United States</country>
            <industry>Financial Services</industry>
            <industryCode>15</industryCode>
            <name>Google Ventures</name>
            <state>CA</state>
            <subIndustry>Venture Capital</subIndustry>
            <subIndustryCode>15_33</subIndustryCode>
            <businessStructure>Subsidiary</businessStructure>
            <companyTypeV2>Private</companyTypeV2>
            <companyStatusV2>Operating</companyStatusV2>
        </company>
        <company>
            <companyId>3221567</companyId>
            <sources/>
            <britishSics/>
            <city>Sao Paulo</city>
            <companyType>Private</companyType>
            <country>Brazil</country>
            <industry>Corporate Services</industry>
            <industryCode>11</industryCode>
            <name>Google Brasil Internet Ltda.</name>
            <state>São Paulo</state>
            <subIndustry>Marketing and Advertising</subIndustry>
            <subIndustryCode>11_27</subIndustryCode>
            <businessStructure>Subsidiary</businessStructure>
            <companyTypeV2>Private</companyTypeV2>
            <companyStatusV2>Operating</companyStatusV2>
        </company>
    </companies>
    <contacts>
        <contact>
            <titles>
                <title>Executive Chairman</title>
            </titles>
            <companyId>1509601</companyId>
            <companyName>Google Finland OY</companyName>
            <contactId>11309612</contactId>
            <fullName>Eric Schmidt</fullName>
            <imageUrl>https://pbs.twimg.com/profile_images/718562527404277760/lj_E05oj_normal.jpg</imageUrl>
        </contact>
        <contact>
            <titles>
                <title>Chief Executive officer and Director</title>
            </titles>
            <companyId>2531488</companyId>
            <companyName>Google Earth</companyName>
            <contactId>11309941</contactId>
            <fullName>John V. Hanke</fullName>
            <imageUrl>https://pbs.twimg.com/profile_images/2899831505/15ef99c6db782414042f6fa64f411405_normal.png</imageUrl>
        </contact>
        <contact>
            <titles>
                <title>Varapääjohtaja, Tuotehallinta</title>
            </titles>
            <companyId>1509601</companyId>
            <companyName>Google Finland OY</companyName>
            <contactId>13932842</contactId>
            <fullName>John V. Hanke</fullName>
            <imageUrl>https://pbs.twimg.com/profile_images/2899831505/15ef99c6db782414042f6fa64f411405_normal.png</imageUrl>
        </contact>
        <contact>
            <titles>
                <title>Vice President</title>
            </titles>
            <companyId>1115342</companyId>
            <companyName>Google Product Search</companyName>
            <contactId>7076214</contactId>
            <fullName>Marissa Mayer</fullName>
        </contact>
        <contact>
            <titles>
                <title>Director</title>
            </titles>
            <companyId>2546544</companyId>
            <companyName>AdMob Google Inc.</companyName>
            <contactId>8156430</contactId>
            <fullName>Maynard George Webb</fullName>
        </contact>
        <contact>
            <titles>
                <title>Chief Financial Officer, Senior Vice President</title>
            </titles>
            <companyId>1750717</companyId>
            <companyName>Google India Private Limited</companyName>
            <contactId>11311948</contactId>
            <fullName>Patrick Pichette</fullName>
        </contact>
        <contact>
            <titles>
                <title>Sr. Engineering Director</title>
            </titles>
            <companyId>7573216</companyId>
            <companyName>Google Inc.</companyName>
            <contactId>89738305</contactId>
            <fullName>Kevin  Scott</fullName>
            <imageUrl>https://pbs.twimg.com/profile_images/862522293846646785/k7QIo4SG_normal.jpg</imageUrl>
        </contact>
        <contact>
            <titles>
                <title>Vice President of Engineering</title>
            </titles>
            <companyId>2546544</companyId>
            <companyName>AdMob Google Inc.</companyName>
            <contactId>8218887</contactId>
            <fullName>Kevin  Scott</fullName>
            <imageUrl>https://pbs.twimg.com/profile_images/862522293846646785/k7QIo4SG_normal.jpg</imageUrl>
        </contact>
        <contact>
            <titles>
                <title>Varapääjohtaja, Tuotehallinta</title>
            </titles>
            <companyId>1509601</companyId>
            <companyName>Google Finland OY</companyName>
            <contactId>11309915</contactId>
            <fullName>Sundar Pichai</fullName>
            <imageUrl>https://pbs.twimg.com/profile_images/684285437087735808/0hxon_fJ_normal.jpg</imageUrl>
        </contact>
        <contact>
            <titles>
                <title>Program Manager</title>
            </titles>
            <companyId>7573216</companyId>
            <companyName>Google Inc.</companyName>
            <contactId>89642249</contactId>
            <fullName>Mike Jennings</fullName>
            <imageUrl>https://pbs.twimg.com/profile_images/603080824/me_too2_normal.jpg</imageUrl>
        </contact>
    </contacts>
    <resultsPerPage>10</resultsPerPage>
</autoComplete>

HTTP 400

Invalid query parameter(s).

HTTP 401

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

HTTP 404

Invalid ID, record not found.

HTTP 405

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

HTTP 429

Request is throttled.