API Release Notes

Follow

InsideView is continuously maintaining and enhancing its API. Therefore, it is normal for bug fixes and backwardly-compatible enhancements to appear without any change in the major version of the API. Specifically, your application should be resilient to the appearance of:

  • Additional endpoints
  • Additional optional fields in requests
  • Additional optional fields in responses
  • Additional error codes
  • Wording changes in the explanatory text of existing error codes

Generally speaking, your code should be resilient insofar as it ignores fields that it isn't utilizing or expecting, and handles errors using standard HTTP/REST conventions. InsideView intends to confine its API fixes and enhancements within a major version such that code that is resilient in these ways will be backwardly-compatible for the lifetime of a major version.

Release History

v1.33 - 2017-03-18

This month we’re excited to introduce a new field in our collection of Company details API.

  • companyTaxId - Company Tax Id is now available as part of Company details API for US companies when available.

v1.30 - 2016-12-19

Internal release for upcoming features.

v1.29 - 2016-11-19

This month we’re excited to introduce a new API to our collection.

  • Contact Async List build API - The InsideView API now has the capability to do an async contact list build. This feature will allow you to run time consuming queries in an offline manner. 

v1.28 - 2016-10-22

This month we’re excited to introduce the following key improvements to our API

v1.27 - 2016-9-24

In This release we have introduced several enhancements.  

  • Local contact geo location is now available to use in the Target Contact List Build API, Data Contact Search API, and People Details APIs. You can do a list build by using “peopleArea”as a filter, and when you want to narrow the list further to contacts who also have headquarters in another specific location, you can do so by combining “peopleArea” with company “cities.”
  • Asynchronous (batch) Target Company List Build API can now be used to build lists that exceed the 100K limit on the standard list build API.
  • Target Contact List Build API responses will now include “peopleId.”
  • Data Company Search API now supports searching by zip code and country filters together.
  • Enrich API (+Bulk) offers a new filter for “contactMatching.” You can choose to match on active employments only (default), inactive ones, or all.
  • In situations where a bulk job is interrupted, it will now resume from the point where it stopped.

v1.26 - 2016-8-28

In this release we have introduced two new functionalities:

·         News Search with company IDs (previously only with new company IDs)

·         Full Name search functionality in Contact Search, Target Contact Search and Lead Enrich APIs.

v1.25 - 2016-7-30

In This release we have introduced several enhancements.    

  • Wrong Info Feedback API for Contacts
    • Last month we introduced the Company Wrong Info Feedback API and now you can help us keep our contacts clean, as well. These new endpoints allow you to submit updated information and track the status of feedback you provide.
  • Target Company Lookup API Enhancements
    • This API now supports tech profiles, diversity information, and company name filters.
  • Contact Full Name
    • Contact Full Name is now available in the response for all APIs that return FirstName and LastName. The list includes: Data Contact Details (normal and bulk), Data People Details, Target Contact List Build, and Target New Contact Details (normal and bulk).
  • Enrich API
    • The Enrich API will now match your data to inactive (past) contacts, when the information is available.

v1.24 - 2016-7-02

In this release we have introduced new endpoints for submitting Wrong Information to Insideview as well as new filters based on Diversity Data for list build APIs. We have also exposed a new custom header for extracting Target Company Insights based on enhanced logic. For more details please visit the company insights news page here.

  • Company Wrong Info Feedback API - With this new API, you can help us keep our database clean by reporting wrong company information. The new endpoints allow you to submit updated information and also track the status of feedback you provided.
  • Now you can collect diversity information as part of a company fetch (+Bulk) or any relevant Target API.  Diversity information includes such things as ethnicity and minority business status.

v1.23 - 2016-6-12

This month, we have a couple of exciting API enhancements to share with you. 

  • We’re now offering a People Subscription API on a charter basis and are looking for a handful of partners who would like to try it out.  The API sends an alert when there is any change to an individual’s profile - as identified by a People ID - indicating which field has changed.  You can then choose whether or not to fetch the updated record.
  • All Bulk APIs now include an optional webhook that will notify you when your job is complete.  No need to keep polling the server to determine when your job is done.  Note: It’s important to validate the webhook when you create the job, as you will not be able to modify it after the job is created.  

v1.22 - 2016-5-07

In this release we have done several enhancements in our APIs.

  • Search with company name is now supported for Target List Build APIs.
  • Added jobLevels, jobFunctions in response of Enrich API and its bulk version.
  • News Alert fetch with timestamp - return standard ISO format instead of long format.

NEW ENDPOINT :TechProfile API with normal companyId in Data APIs.

v1.21 - 2016-4-16

 In this release, we have introduced several new APIs:

  • Reference API for TechProfile

  • API to fetch TechProfile details of a company using new id.

  • API (Target Company Insights News Search API) to search company news at granular level using new company id.

  • API (Target Company Insights News details API) to get company news based on articleIds (get articleIds using Target Company Insights News Search API).

  • Subscription API – New API to get granular details about alerts

Note: The capability to fetch TechProfile details is available only for Target Company List API and not for Target Contact List API.

New Improvements:

  • We have also added new filters in Target company list api:  “categoryIds”, “subCategoryIds” & “productIds”.
  • New fields “firstName” & “lastName” in response of Target Contact List API.
  • New field “peopleId” in response of all contact fetch related endpoints including enrich.
  • Support for Multiple states in Target company and contact list APIs.

 

v1.20 - 2016-3-12

In this release, we have introduced reference APIs for Job levels and Job functions along with Charter release of People Fetch APIs.

  • Reference API’s for jobLevel and jobFunction.
  •  Adding “jobLevels”, “jobFunctions” fields in contact fetch (+Bulk) , target contact fetch (+Bulk) APIs.
  •  People Fetch API - {{url}}/v1/people/{peopleId}

v1.19 - 2016-2-13

In this release, we have introduced new API to get Tech profile for a given company. We have also introduced validation of webhooks for Subscription APIs.

  • Tech Profile API - {{url}}/v1/company/{companyId}/insights/techProfile

v1.18 - 2016-1-23

In this release, we have introduced one new APIs to fetch company logos. Logos are available in three different sizes. Please note that not all companies have logos. 

  • Company Logo API - {{url}}/v1/company/{companyId}/logos

v1.17 - 2015-12-19

Internal release for upcoming features.

v1.16 - 2015-11-28

In this release, we have introduced two new APIs for company and contact news. 

  • Company News Feed API - {{url}}/v1/company/{companyId}/newsFeed
  • Contact News Feed API - {{url}}/v1/contact/{contactId}/newsFeed

v1.15 - 2015-11-07

Usability Improvements

  • Include Job Level and Job Function attributes in Target Contact Lookup API response. 
  • revenueRange, employeeRange, foundationDate is added in company related endpoints.

This release also kick starts the Free API trial program and Subscription API Charter program.

v1.14 - 2015-10-10

Family Tree API - Company Family Tree

  • New Family Tree API -{{url}}/v1/company/{companyId}/familyTree

Usability Improvements

  • Target contact List Build – The parameters “companyIdsToInclude” and “companyIdsToExclude” supports both Scrambled CompanyIds and normal CompanyIds.

 

v1.13 - 2015-09-12

Company Lookup API -  Company Lookup 

  • New end point {{url}}/v1/target/company/lookup

Usability Improvements

  • Consumption History Usage API ( URL is appended to the response ) 
  • Show credits consumed for all bulk jobs in list all bulk jobs List Bulk Jobs 

Error handling for Bulk Job API's

 

v1.12 - 2015-08-08

In This release we continue to improve our API capabilities by supporting additional filters and fields. We have also introduced the bulk API version for new company details endpoint.

  • Richer filters
    • Enrich APIs allow the following new filters:
      • isContactRequire
      • isEmailRequired
      • isPhoneRequired
    • Target Contact List APIs allow the following new filters:
      • companyIdsToExclude
      • companyIdsToInclude
  • Richer responses
    • Contact related APIs
      • age (Data Contacts Details API, Enrich API, Target New Contact Details API)
      • salary (Data Contacts Details API, Enrich API, Target New Contact Details API)
      • salaryCurrency (Data Contacts Details API, Enrich API, Target New Contact Details API)
    • Company related APIs
      • mostRecentQuarter (Data Company Details API, Enrich API, Target New Company Details API)
  • New Endpoint - Target New Company Details
  • Fixed bugs 

v1.11 - 2015-07-11

The main goal with v1.11 is to bring a host of small enhancements both in terms of richer filters and richer responses.  Please see each endpoint documentation for more details.

Note: for each modification, both the regular and the bulk versions received the enhancements. 

  • Richer filters
    • Contact related APIs allow the following new filters:
      • isPhoneRequired (Target Contact List API, Target Contact Lookup API)
      • isEmailRequired (Target Contact List API, Target Contact Lookup API)
      • active (Data Contact Search API, Target Contact List API, Target Contact Lookup API)
      • companyIdsToInclude (Target Contact List API): allows finding contacts within a set of companies
  • Richer responses
    • Contact related APIs
      • active (Data Contacts Details API, Target Contact Lookup API, Target New Contact Details API)
      • Contact Lookup API, Target New Contact Details API) 
      • hasPhone (Data Contact Search API, Target Contact List API)
      • hasEmail (Data Contact Search API, Target Contact List API) 
    • Company related APIs
      • parentCompanyName (Enrich API, Data Company Details API, Target New Company Details API)
      • parentCompanyCountry (Enrich API, Data Company Details API, Target New Company Details API)
      • ultimateParentCompanyName (Enrich API, Data Company Details API, Target New Company Details API)
      • ultimateParentCompanyCountry (Enrich API, Data Company Details API, Target New Company Details API)
      • zip (Target Company List API)
  • Target New Contact Details API: new query parameter retrieveCompanyDetails: optionally fetch company details when fetching new contact details
    See the documentation for more details   
  • Administration APIs: added a new API to list current and past job submitted from various bulk APIs
    See the documentation for more details  
  • Fixed bugs

 

v1.10.1 - 2015-06-16

  • Fixed some bugs

v1.10.0 - 2015-05-16

  • First 2 APIs in the new Person API collection
    • Person Search API – find a person based on his or her email address or name.
      See the documentation for more details.
    • Person Details API – retrieve up to a dozen details about a person, including photo, bio, education details, and more.
      See the documentation for more details.
  • Target API enhancements
    • Get up to 500 Contact and Company List API responses on a page.
      See the documentation for more details.
  • Enrich API enhancements
    • See matching scores and select a minimum score for the API to return a result.
      See the documentation for more details.
    • Track match rates and view results with the API Usage API.
      See the documentation for more details.
  • Admin API additions to fetch reference data
    • Countries List API – retrieve the list of available countries and their codes.
      See the documentation more details.
    • Industries List API – retrieve the list of industries and sub-industries, and their codes.
      See the documentation for more details.
  • Fixed some bugs

v1.9.0 - 2015-04-18

 

v1.8.0 - 2015-04-04

  • Internationalization: some endpoints have been updated in order to support the standard Accept-Language HTTP header.  It allows to retrieve a localized version industry and subIndustry fields and to have revenues in a currency corresponding to the locale passed.  The currency is indicated in a new field, revenueCurrency.
    The following locales are supported:  en-en, en-uk, en-ie, de-de, fr-fr, nl-nl and sp-sp. 
    See the documentation for more details, including the list of endpoints impacted.
  • Endpoints supporting internationalization also include the following new attributes: industryCode and subIndustryCode 
    See the documentation for the list of industry and sub-industry codes. 
  • Fixed some bugs
 

v1.7.0 - 2015-02-21

  • Released in the Insights API collection a set of API to access and manage InsideView for Sales users watchlists
    See the documentation for more details
  • Added an attribute to the Company News Agent API in the Insights API Collection: imageUrl.  It provide a link to an image associated with the news article.
    See the documentation for more details
  • Added some attributes to the Contact Lookup API in the Target API collection: hasPhone, hasEmail, hasTwitterHandle, hasLinkedInHandle, hasFacebookHandle. 
    These attributes help making the decision to fetch the details of a specific lookup results to access valuable information.
    See the documentation for more details
  • The Bulk Contact Lookup API in the Target API collection is GA.
    See the documentation for more details
  • Fixed some bugs

 

v1.6.0 - 2015-01-31

  • Released bulk version of the TargetAPI Collection's Contact Lookup endpoint in BETA
    See the endpoint documentation for more details 
  • Fixed some bugs

 

v1.5.0 - 2015-01-03

  • Released the Contact List endpoints in the Target API Collection:  
    • Contact List API. It allows retrieving a list of contacts using advanced search parameters.
      See the endpoint documentation for more details
    • Contact List Count API. It allows counting the number of results a Contact List API call would retrieve.
      See the endpoint documentation for more details
  • Added an attribute to the Target API collection's Contact Lookup endpoint response:  an MD5 hash of the contact email, allowing to detect contacts you already own.
    See the endpoint documentation for more details 
  • Released bulk version of the Target API Collection's New Contact Details endpoint.
    See the endpoint documentation for more details 
  • Fixed some bugs
  • Added to the documentation a page to help navigating the API endpoints documentation

 

v1.4.0 - 2014-12-06

  • Released the Company List endpoints in the Target API Collection:  
    • Company List API. It allows retrieving a list of companies using advanced search parameters.
      See the endpoint documentation for more details
    • Company List Count API. It allows counting the number of results a Company List API call would retrieve.
      See the endpoint documentation for more details
    • New Company Details API. It allows retrieving the full details of a company found using the Company List API.
      See the endpoint documentation for more details
  • Fixed some bugs

 

v1.3.0 - 2014-11-01

  • Released the first 2 API in the Insights API collection - please note that these endpoints are beta endpoints:  
    • Company News Agents API. It allows retrieving news feed sorted by our standard smart agents for a specific company.
      See the endpoint documentation for more details
    • Company News Agents Count API. It allows counting news per standard smart agents for a specific company.
      See the endpoint documentation for more details
  • Fixed some bugs

 

v1.2.0 - 2014-10-03

  • Released an Administration API: Usage API. It allows retrieving details on your past API usage as well as some details on your API credits consumption.
    See API usage article for more details
  • Fixed some bugs

 

v1.1.1 - 2014-09-05

  • CORS is now supported. Please contact InsideView Support for enabling and configuring this feature
  • Fixed some bugs

 

v1.1 - 2014-08-09

Known Issues

  • CORS is not supported.

 

v1.0.1 - 2014-07-04

  • Added a new optional parameter active to contacts API to allow returning only contacts with active or inactive employment records. When the parameter is omitted both active and inactive ones are returned
  • Improved search results relevance for the contacts API
  • Fixed some bugs

Known Issues

  • CORS is not supported.

 

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