[POST] - Enrich

Use the Enrich endpoint to fetch company and contact information in a single query. This resource enables your users to search based on one or more inputs, and immediately retrieve only the highest ranked information for the combination of inputs.

Endpoint

POST https://api.insideview.com/api/v1/enrich

Request

HTTP Headers

Form Parameters

The parameters should be sent as x-www-form-urlencoded parameters.

Note:  sending the parameters as form-data parameters will generate an error.

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. 

The response, in case of a match, contains a company record and a contact record if a contact is also matched.

If there is no match the response will be an empty JSON structure or an empty enrichedLead node in an XML document depending on the Accept header of the query.

application/json Example (without a match)

{}

application/xml Example (without a match)

<?xml version="1.0" encoding="UTF-8"?>
<enrichedLead/>

application/json Example (with a match)

{
  "company": {
    "city": "CUPERTINO",
    "companyId": 724468,
    "companyStatus": "Operating",
    "companyType": "Public",
    "country": "United States",
    "employees": "500000",
    "equifaxId": "19571340",
    "fax": "(408) 996-0275",
    "financialYearEnd": "9",
    "industry": "Computerhardware",
    "naics": "334118",
    "naicsDescription": "Computer Terminal and Other Computer Peripheral Equipment Manufacturing",
    "name": "Apple Inc.",
    "phone": "1-408-9961010",
    "revenue": "176634.78555",
    "sic": "3663",
    "sicDescription": "Radio & Tv Broadcasting & Communications Equipment",
    "state": "CA",
    "street": "1 Infinite Loop",
    "subIndustry": "Computerhardware",
    "tickers": [
      {
        "tickerName": "AAPL",
        "exchange": "NASD"
      }
    ],
    "zip": "95014-2083",
    "mostRecentQuarter": "Jun, 2016",
    "revenueCurrency": "EUR",
    "industryCode": "6",
    "britishSics": [
      {
        "britishSic": "46510",
        "description": "Wholesale of computers, computer peripheral equipment and software"
      },
      {
        "britishSic": "26200",
        "description": "Manufacture of computers and peripheral equipment"
      }
    ],
    "fortuneRanking": "5",
    "foundationDate": "1976",
    "companyFacebookProfile": "615085188507202",
    "companyTwitterProfile": "AppStore",
    "companyBlogProfile": "http://time.com/3965742/husband-smoking-google-street-view/feed/",
    "companyLinkedInProfile": "https://www.linkedin.com/company/apple",
    "sources": [
      "User Generated",
      "Web References",
      "Reuters",
      "InsideView",
      "Community",
      "Equifax",
      "Cortera"
    ],
    "websites": [
      "www.apple.com"
    ]
  },
  "contact": {
    "contactId": "17710764",
    "firstName": "Michael",
    "lastName": "Cook",
    "fullName": "Michael Cook",
    "corporate": +44 800 1010",
    "direct" : +939 4321 3433,
    "linkedInProfile": "http://www.linkedin.com/pub/michael-cook/0/289/51b",
    "age": "0",
    "peopleId": "e_zAKbaifnjVHnLb-UjHLA-RjQm5H3IXpFCAGyUwPUGOUzkD8sJpNs8_scbt2s1X",
    "jobLevels": [
      "Other"
    ],
    "jobFunctions": [
      "Sales",
      "Operations and Administration"
    ],
    "jobLevelsV2": [
       {
         "id": "0",
         "name": "Board Member"
       },
       {
         "id": "2",
         "name": "Senior Executive"
       }
    ],
    "jobFunctionsV2": [
       {
         "id": "22",
         "name": "Others"
       }
    ],
    "active": true,
    "sources": [
      "Web References"
    ],
    "titles": [
      "Director, Retail Operations"
    ]
  },
  "confidenceScore": "50.016148"
}

application/xml Example (with a match)

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<enrichedLead>
    <company>
        <city>CUPERTINO</city>
        <companyId>724468</companyId>
        <companyStatus>Operating</companyStatus>
        <companyType>Public</companyType>
        <country>United States</country>
        <employees>500000</employees>
        <equifaxId>19571340</equifaxId>
        <fax>(408) 996-0275</fax>
        <financialYearEnd>9</financialYearEnd>
        <industry>Computerhardware</industry>
        <naics>334118</naics>
        <naicsDescription>Computer Terminal and Other Computer Peripheral Equipment Manufacturing</naicsDescription>
        <name>Apple Inc.</name>
        <phone>1-408-9961010</phone>
        <revenue>176634.78555</revenue>
        <sic>3663</sic>
        <sicDescription>Radio &amp; Tv Broadcasting &amp; Communications Equipment</sicDescription>
        <state>CA</state>
        <street>1 Infinite Loop</street>
        <subIndustry>Computerhardware</subIndustry>
        <tickers>
            <ticker>
                <exchange>NASD</exchange>
                <tickerName>AAPL</tickerName>
            </ticker>
        </tickers>
        <websites>
            <website>www.apple.com</website>
        </websites>
        <zip>95014-2083</zip>
        <sources>
            <source>User Generated</source>
            <source>Web References</source>
            <source>Reuters</source>
            <source>InsideView</source>
            <source>Community</source>
            <source>Equifax</source>
            <source>Cortera</source>
        </sources>
        <britishSics>
            <britishSicDetails>
                <britishSic>46510</britishSic>
                <description>Wholesale of computers, computer peripheral equipment and software</description>
            </britishSicDetails>
            <britishSicDetails>
                <britishSic>26200</britishSic>
                <description>Manufacture of computers and peripheral equipment</description>
            </britishSicDetails>
        </britishSics>
        <companyBlogProfile>http://time.com/3965742/husband-smoking-google-street-view/feed/</companyBlogProfile>
        <companyFacebookProfile>615085188507202</companyFacebookProfile>
        <companyLinkedInProfile>https://www.linkedin.com/company/apple</companyLinkedInProfile>
        <companyTwitterProfile>AppStore</companyTwitterProfile>
        <fortuneRanking>5</fortuneRanking>
        <foundationDate>1976</foundationDate>
        <industryCode>6</industryCode>
        <mostRecentQuarter>Jun, 2016</mostRecentQuarter>
        <revenueCurrency>EUR</revenueCurrency>
    </company>
    <confidenceScore>50.016148</confidenceScore>
    <contact>
        <contactId>17710764</contactId>
        <firstName>Michael</firstName>
        <lastName>Cook</lastName>
        <fullName>Michael Cook</fullName>
        <corporatePhone>+44 800 1010</corporatePhone>
        <directPhone>+939 4321 3433</directPhone>
        <linkedInProfile>http://www.linkedin.com/pub/michael-cook/0/289/51b</linkedInProfile>
        <titles>
            <title>Director, Retail Operations</title>
        </titles>
        <sources>
            <source>Web References</source>
        </sources>
        <jobLevels>
            <jobLevel>Other</jobLevel>
        </jobLevels>
        <jobFunctions>
            <jobFunction>Sales</jobFunction>
            <jobFunction>Operations and Administration</jobFunction>
        </jobFunctions>
        <jobLevelsV2>
            <jobLevelV2>
                <id>0</id>
                <name>Board Member</name>
            </jobLevelV2>
            <jobLevelV2>
                <id>2</id>
                <name>Senior Executive</name>
            </jobLevelV2>
        </jobLevelsV2>
        <jobFunctionsV2>
            <jobFunctionV2>
                <id>22</id>
                <name>Others</name>
            </jobFunctionV2>
        </jobFunctionsV2>
        <active>true</active>
        <age>0</age>
        <peopleId>e_zAKbaifnjVHnLb-UjHLA-RjQm5H3IXpFCAGyUwPUGOUzkD8sJpNs8_scbt2s1X</peopleId>
    </contact>
</enrichedLead>

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.