[GET] - Company Auto Complete API

Follow

Use this end point to auto complete Company names based on search query. The query can also returns 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

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
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

application/json example

{
   "companies": [
      {
         "name": "Apple Inc.",
         "companyType": "Public",
         "industry": "Consumer Product Manufacturing",
         "subIndustry": "Consumer Electronics",
         "city": "Cupertino",
         "state": "CA",
         "country": "United States",
         "industryCode": "10",
         "subIndustryCode": "10_8",
         "companyId": 724468
      },
      {
         "name": "Applebee's International, Inc.",
         "companyType": "Private",
         "industry": "Leisure, Sports and Recreation",
         "subIndustry": "Restaurants, Bars and Eateries",
         "city": "Glendale",
         "state": "CA",
         "country": "United States",
         "industryCode": "22",
         "subIndustryCode": "22_17",
         "companyId": 228
      },
      {
         "name": "Apple American Group, LLC",
         "companyType": "Private",
         "industry": "Leisure, Sports and Recreation",
         "subIndustry": "Restaurants, Bars and Eateries",
         "city": "Independence",
         "state": "OH",
         "country": "United States",
         "industryCode": "22",
         "subIndustryCode": "22_17",
         "companyId": 22398
      },
      {
         "name": "Apple Federal Credit Union",
         "companyType": "Private",
         "industry": "Banks",
         "subIndustry": "Credit Unions",
         "city": "Fairfax",
         "state": "VA",
         "country": "United States",
         "industryCode": "4",
         "subIndustryCode": "4_6",
         "companyId": 3028168
      },
      {
         "name": "Apple Leisure Group",
         "companyType": "Private",
         "industry": "Leisure, Sports and Recreation",
         "subIndustry": "Hotels and Motels",
         "city": "Newtown Square",
         "state": "PA",
         "country": "United States",
         "industryCode": "22",
         "subIndustryCode": "22_9",
         "companyId": 1493840
      },
      {
         "name": "Appleton Grp LLC",
         "companyType": "Private",
         "industry": "Construction and Building Materials",
         "subIndustry": "Electric Lighting and Wiring",
         "city": "Rosemont",
         "state": "IL",
         "country": "United States",
         "industryCode": "9",
         "subIndustryCode": "9_10",
         "companyId": 546377
      },
      {
         "name": "Applegate Farms LLC",
         "companyType": "Private",
         "industry": "Food and Beverage",
         "subIndustry": "Dairy Products",
         "city": "Bridgewater",
         "state": "NJ",
         "country": "United States",
         "industryCode": "16",
         "subIndustryCode": "16_9",
         "companyId": 2657071
      },
      {
         "name": "Appleseed's, Inc.",
         "companyType": "Private",
         "industry": "Consumer Product Manufacturing",
         "subIndustry": "Women's Clothing",
         "city": "Warren",
         "state": "PA",
         "country": "United States",
         "industryCode": "10",
         "subIndustryCode": "10_49",
         "companyId": 915390
      },
      {
         "name": "Apple Bank For Savings",
         "companyType": "Private",
         "industry": "Banks",
         "subIndustry": "Savings Institutions",
         "city": "Manhasset",
         "state": "NY",
         "country": "United States",
         "industryCode": "4",
         "subIndustryCode": "4_12",
         "companyId": 19462
      },
      {
         "name": "Red Apple Group, Inc.",
         "companyType": "Private",
         "industry": "Retail",
         "subIndustry": "Hyper and Supermarkets",
         "city": "New York",
         "state": "NY",
         "country": "United States",
         "industryCode": "27",
         "subIndustryCode": "27_25",
         "companyId": 5397
      }
   ],
   "contacts": [
      {
         "contactId": 11085706,
         "imageUrl": "https://pbs.twimg.com/profile_images/988262236299788288/8RSTZPjZ.jpg",
         "companyId": 724468,
         "companyName": "Apple Inc.",
         "fullName": "Marc  Benioff",
         "titles": [
            "Programmer"
         ]
      },
      {
         "contactId": 225,
         "imageUrl": "https://pbs.twimg.com/profile_images/1035649273721847809/B0f8n_oe.jpg",
         "companyId": 724468,
         "companyName": "Apple Inc.",
         "fullName": "Tim Cook",
         "titles": [
            "Chief Executive Officer and Board Member"
         ]
      },
      {
         "contactId": 152378,
         "imageUrl": "https://pbs.twimg.com/profile_images/511582119793930240/JgGOe77c_normal.jpeg",
         "companyId": 724468,
         "companyName": "Apple Inc.",
         "fullName": "Eric E. Schmidt",
         "titles": [
            "Director"
         ]
      },
      {
         "contactId": 7751037,
         "companyId": 724468,
         "companyName": "Apple Inc.",
         "fullName": "Steve Jobs",
         "titles": [
            "Chairman"
         ]
      },
      {
         "contactId": 227,
         "imageUrl": "https://pbs.twimg.com/profile_images/755268949017698304/TDhoXK3l.jpg",
         "companyId": 724468,
         "companyName": "Apple Inc.",
         "fullName": "Philip Schiller",
         "titles": [
            "Senior Vice President - Worldwide Marketing"
         ]
      },
      {
         "contactId": 4095303,
         "imageUrl": "https://pbs.twimg.com/profile_images/486312359443447808/X2SFZMYp.jpeg",
         "companyId": 724468,
         "companyName": "Apple Inc.",
         "fullName": "Caroline Donahue",
         "titles": [
            "Channel Management Positions"
         ]
      },
      {
         "contactId": 12860631,
         "companyId": 724468,
         "companyName": "Apple Inc.",
         "fullName": "Daniel Gaudreau",
         "titles": [
            "Non Management Executive"
         ]
      },
      {
         "contactId": 12938110,
         "companyId": 724468,
         "companyName": "Apple Inc.",
         "fullName": "Robert Calderoni",
         "titles": [
            "Senior Vice President of Finance and Corporate Controller"
         ]
      },
      {
         "contactId": 234,
         "companyId": 724468,
         "companyName": "Apple Inc.",
         "fullName": "Peter Oppenheimer",
         "titles": [
            "Senior Vice President and Chief Financial Officer"
         ]
      },
      {
         "contactId": 2294727,
         "imageUrl": "https://pbs.twimg.com/profile_images/669412077090512896/-AXy_RxZ.jpg",
         "companyId": 724468,
         "companyName": "Apple Inc.",
         "fullName": "Andrea Jung",
         "titles": [
            "Independent Director"
         ]
      }
   ],
   "resultsPerPage": 10
}

application/xml example

<?xml version="1.0" encoding="UTF-8"?>
<autoComplete>
   <companies>
      <company>
         <companyId>724468</companyId>
         <sources />
         <britishSics />
         <city>Cupertino</city>
         <companyType>Public</companyType>
         <country>United States</country>
         <industry>Consumer Product Manufacturing</industry>
         <industryCode>10</industryCode>
         <name>Apple Inc.</name>
         <state>CA</state>
         <subIndustry>Consumer Electronics</subIndustry>
         <subIndustryCode>10_8</subIndustryCode>
      </company>
      <company>
         <companyId>228</companyId>
         <sources />
         <britishSics />
         <city>Glendale</city>
         <companyType>Private</companyType>
         <country>United States</country>
         <industry>Leisure, Sports and Recreation</industry>
         <industryCode>22</industryCode>
         <name>Applebee's International, Inc.</name>
         <state>CA</state>
         <subIndustry>Restaurants, Bars and Eateries</subIndustry>
         <subIndustryCode>22_17</subIndustryCode>
      </company>
      <company>
         <companyId>22398</companyId>
         <sources />
         <britishSics />
         <city>Independence</city>
         <companyType>Private</companyType>
         <country>United States</country>
         <industry>Leisure, Sports and Recreation</industry>
         <industryCode>22</industryCode>
         <name>Apple American Group, LLC</name>
         <state>OH</state>
         <subIndustry>Restaurants, Bars and Eateries</subIndustry>
         <subIndustryCode>22_17</subIndustryCode>
      </company>
      <company>
         <companyId>3028168</companyId>
         <sources />
         <britishSics />
         <city>Fairfax</city>
         <companyType>Private</companyType>
         <country>United States</country>
         <industry>Banks</industry>
         <industryCode>4</industryCode>
         <name>Apple Federal Credit Union</name>
         <state>VA</state>
         <subIndustry>Credit Unions</subIndustry>
         <subIndustryCode>4_6</subIndustryCode>
      </company>
      <company>
         <companyId>1493840</companyId>
         <sources />
         <britishSics />
         <city>Newtown Square</city>
         <companyType>Private</companyType>
         <country>United States</country>
         <industry>Leisure, Sports and Recreation</industry>
         <industryCode>22</industryCode>
         <name>Apple Leisure Group</name>
         <state>PA</state>
         <subIndustry>Hotels and Motels</subIndustry>
         <subIndustryCode>22_9</subIndustryCode>
      </company>
      <company>
         <companyId>546377</companyId>
         <sources />
         <britishSics />
         <city>Rosemont</city>
         <companyType>Private</companyType>
         <country>United States</country>
         <industry>Construction and Building Materials</industry>
         <industryCode>9</industryCode>
         <name>Appleton Grp LLC</name>
         <state>IL</state>
         <subIndustry>Electric Lighting and Wiring</subIndustry>
         <subIndustryCode>9_10</subIndustryCode>
      </company>
      <company>
         <companyId>2657071</companyId>
         <sources />
         <britishSics />
         <city>Bridgewater</city>
         <companyType>Private</companyType>
         <country>United States</country>
         <industry>Food and Beverage</industry>
         <industryCode>16</industryCode>
         <name>Applegate Farms LLC</name>
         <state>NJ</state>
         <subIndustry>Dairy Products</subIndustry>
         <subIndustryCode>16_9</subIndustryCode>
      </company>
      <company>
         <companyId>915390</companyId>
         <sources />
         <britishSics />
         <city>Warren</city>
         <companyType>Private</companyType>
         <country>United States</country>
         <industry>Consumer Product Manufacturing</industry>
         <industryCode>10</industryCode>
         <name>Appleseed's, Inc.</name>
         <state>PA</state>
         <subIndustry>Women's Clothing</subIndustry>
         <subIndustryCode>10_49</subIndustryCode>
      </company>
      <company>
         <companyId>19462</companyId>
         <sources />
         <britishSics />
         <city>Manhasset</city>
         <companyType>Private</companyType>
         <country>United States</country>
         <industry>Banks</industry>
         <industryCode>4</industryCode>
         <name>Apple Bank For Savings</name>
         <state>NY</state>
         <subIndustry>Savings Institutions</subIndustry>
         <subIndustryCode>4_12</subIndustryCode>
      </company>
      <company>
         <companyId>5397</companyId>
         <sources />
         <britishSics />
         <city>New York</city>
         <companyType>Private</companyType>
         <country>United States</country>
         <industry>Retail</industry>
         <industryCode>27</industryCode>
         <name>Red Apple Group, Inc.</name>
         <state>NY</state>
         <subIndustry>Hyper and Supermarkets</subIndustry>
         <subIndustryCode>27_25</subIndustryCode>
      </company>
   </companies>
   <contacts>
      <contact>
         <titles>
            <title>Programmer</title>
         </titles>
         <companyId>724468</companyId>
         <companyName>Apple Inc.</companyName>
         <contactId>11085706</contactId>
         <fullName>Marc  Benioff</fullName>
         <imageUrl>https://pbs.twimg.com/profile_images/988262236299788288/8RSTZPjZ.jpg</imageUrl>
      </contact>
      <contact>
         <titles>
            <title>Chief Executive Officer and Board Member</title>
         </titles>
         <companyId>724468</companyId>
         <companyName>Apple Inc.</companyName>
         <contactId>225</contactId>
         <fullName>Tim Cook</fullName>
         <imageUrl>https://pbs.twimg.com/profile_images/1035649273721847809/B0f8n_oe.jpg</imageUrl>
      </contact>
      <contact>
         <titles>
            <title>Director</title>
         </titles>
         <companyId>724468</companyId>
         <companyName>Apple Inc.</companyName>
         <contactId>152378</contactId>
         <fullName>Eric E. Schmidt</fullName>
         <imageUrl>https://pbs.twimg.com/profile_images/511582119793930240/JgGOe77c_normal.jpeg</imageUrl>
      </contact>
      <contact>
         <titles>
            <title>Chairman</title>
         </titles>
         <companyId>724468</companyId>
         <companyName>Apple Inc.</companyName>
         <contactId>7751037</contactId>
         <fullName>Steve Jobs</fullName>
      </contact>
      <contact>
         <titles>
            <title>Senior Vice President - Worldwide Marketing</title>
         </titles>
         <companyId>724468</companyId>
         <companyName>Apple Inc.</companyName>
         <contactId>227</contactId>
         <fullName>Philip Schiller</fullName>
         <imageUrl>https://pbs.twimg.com/profile_images/755268949017698304/TDhoXK3l.jpg</imageUrl>
      </contact>
      <contact>
         <titles>
            <title>Channel Management Positions</title>
         </titles>
         <companyId>724468</companyId>
         <companyName>Apple Inc.</companyName>
         <contactId>4095303</contactId>
         <fullName>Caroline Donahue</fullName>
         <imageUrl>https://pbs.twimg.com/profile_images/486312359443447808/X2SFZMYp.jpeg</imageUrl>
      </contact>
      <contact>
         <titles>
            <title>Non Management Executive</title>
         </titles>
         <companyId>724468</companyId>
         <companyName>Apple Inc.</companyName>
         <contactId>12860631</contactId>
         <fullName>Daniel Gaudreau</fullName>
      </contact>
      <contact>
         <titles>
            <title>Senior Vice President of Finance and Corporate Controller</title>
         </titles>
         <companyId>724468</companyId>
         <companyName>Apple Inc.</companyName>
         <contactId>12938110</contactId>
         <fullName>Robert Calderoni</fullName>
      </contact>
      <contact>
         <titles>
            <title>Senior Vice President and Chief Financial Officer</title>
         </titles>
         <companyId>724468</companyId>
         <companyName>Apple Inc.</companyName>
         <contactId>234</contactId>
         <fullName>Peter Oppenheimer</fullName>
      </contact>
      <contact>
         <titles>
            <title>Independent Director</title>
         </titles>
         <companyId>724468</companyId>
         <companyName>Apple Inc.</companyName>
         <contactId>2294727</contactId>
         <fullName>Andrea Jung</fullName>
         <imageUrl>https://pbs.twimg.com/profile_images/669412077090512896/-AXy_RxZ.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 405

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

HTTP 429

Request is throttled.

 

Was this article helpful?
0 out of 0 found this helpful
Powered by Zendesk