[GET] - Company News Agents – InsideView

Use the Insights API's Company News Agents endpoint to retrieve categorized news for a specific company.

Endpoint

GET https://api.insideview.com/api/v1/insights/company/{companyId}/agents

Request

HTTP Headers

Header Name

Type

Required

Description

accessToken

String

Yes

Valid access token.
See Authentication and Authorization Overview for more details.

String

Selects the response's content type.
Valid values are application/json and application/xml (default).

Use below mentioned values to access New News Platform based search

application/api.insights.beta+json

application/api.insights.beta+xml

URI Parameters

Parameter Name	Type	Required	Description
companyId	Integer	Yes	A valid company ID

Query Parameters

Parameter Name	Type	Required	Description
days	Integer	Yes	Period length, ending with the current date to retrieve news for. Max value: 30
agents	String	Yes	A comma separated list of agents ID (see below)
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

Agent Name	ID
Leadership Changes	LEADERSHIP_CHANGES
New Offerings	NEW_OFFERINGS
Acquisitions	ACQUISITIONS
Partnerships	PARTNERSHIPS
Expanding Operations	EXPANDING_OPERATIONS
Cost Cutting	COST_CUTTING
Outperforming	OUTPERFORMING
Underperforming	UNDERPERFORMING
Company Presentation	COMPANY_PRESENTATION
Litigation	LITIGATION
Compliance	COMPLIANCE
Research & Development	RESEARCH_DEVELOPMENT
Data Security	DATA_SECURITY
Funding Developments	FUNDING_DEVELOPMENTS
Bankruptcy & Restructuring	BANKRUPTCY_RESTRUCTURING
Real Estate: Deals	REALESTATE_DEALS
Real Estate: Construction	REALESTATE_CONSTRUCTION
Corporate Challenges	CORPORATE_CHALLENGES

Responses

Here are the major responses the API may return.

for details on the errors, please refer to the API Error Codes article.

HTTP 200

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

Name	type	Description
companyNews	Array	Array of company news
companyNews > title	String	News title
companyNews > url	String	News URL
companyNews > publicationDate	Date	Publication date and time (PST) of the article
companyNews > source	String	Article source
companyNews > agents	String	Categorization of the news
companyNews > imageUrl	String	URL of an image from the article.
companyNews > similarNewsCount	Integer	Number of similar news (not listed)
page	Integer	Page number in the result set
resultsPerPage	Integer	Number of search result per page
totalResults	Integer	Total number of search results
currentCompanyId	Integer	The current ID of the company

application/json Example

{
   "companyNews": [
      {
         "title": "Google said to buy office buildings for RM1.9bil",
         "url": "http://my.insideview.com/iv/launchReferredArticle.do?aid=19347156172&cid=736233",
         "publicationDate": "Oct 23, 2014 10:51:00 PM PDT",
         "source": "KiniBiz",
         "agents": "ACQUISITIONS"
      },
      {
         "title": "Google Said to Buy Redwood City Offices for $585 Million",
         "url": "http://my.insideview.com/iv/launchReferredArticle.do?aid=19346813726&cid=736233",
         "publicationDate": "Oct 23, 2014 9:54:00 PM PDT",
         "source": "Bloomberg",
         "agents": "ACQUISITIONS"
      },
      {
         "title": "Firebase acquired by Google",
         "url": "http://my.insideview.com/iv/launchReferredArticle.do?aid=19330083354&cid=736233",
         "publicationDate": "Oct 22, 2014 8:52:00 AM PDT",
         "source": "Individual.com",
         "agents": "ACQUISITIONS"
      },
      {
         "title": "Google buys Firebase to add real-time sync & store capabilities to its Cloud Platform",
         "url": "http://my.insideview.com/iv/launchReferredArticle.do?aid=19328853169&cid=736233",
         "publicationDate": "Oct 22, 2014 6:43:00 AM PDT",
         "source": "ServicesAngle",
         "agents": "ACQUISITIONS"
      },
      {
         "title": "Google Acquires Firebase To Shore Up App Development Platform",
         "url": "http://my.insideview.com/iv/launchReferredArticle.do?aid=19328800188&cid=736233",
         "publicationDate": "Oct 22, 2014 6:38:00 AM PDT",
         "source": "Bidness Etc",
         "agents": "ACQUISITIONS",
         "similarNewsCount": "3"
      },
      {
         "title": "Himax Technologies Tumbles; Google Won't Boost Stake",
         "url": "http://my.insideview.com/iv/launchReferredArticle.do?aid=19327737383&cid=736233",
         "publicationDate": "Oct 22, 2014 4:37:00 AM PDT",
         "source": "Benzinga.com",
         "agents": "ACQUISITIONS"
      },
      {
         "title": "Google Buys Firebase to Add Cloud-Computing Mobile Tools",
         "url": "http://my.insideview.com/iv/launchReferredArticle.do?aid=19319789202&cid=736233",
         "publicationDate": "Oct 21, 2014 10:49:00 AM PDT",
         "source": "BusinessWeek",
         "agents": "ACQUISITIONS",
         "similarNewsCount": "2"
      },
      {
         "title": "Report: Google taps Android exec to lead Chrome engineering team",
         "url": "http://my.insideview.com/iv/launchReferredArticle.do?aid=19306120365&cid=736233",
         "publicationDate": "Oct 20, 2014 6:45:00 AM PDT",
         "source": "SNL Financial",
         "agents": "LEADERSHIP_CHANGES"
      },
      {
         "title": "White House nominates former Google exec to lead US patent office",
         "url": "http://my.insideview.com/iv/launchReferredArticle.do?aid=19282765680&cid=736233",
         "publicationDate": "Oct 17, 2014 12:56:00 PM PDT",
         "source": "Big News Network",
         "agents": "LEADERSHIP_CHANGES"
      }
   ],
   "page": 1,
   "resultsPerPage": 9,
   "totalResults": 9,
   "companyId": 726263,
   "currentCompanyId": 1755
}

application/xml Example

<?xml version="1.0" encoding="UTF-8"?>
<news>
   <article>
      <agents>ACQUISITIONS</agents>
      <publicationDate>Oct 23, 2014 10:51:00 PM PDT</publicationDate>
      <source>KiniBiz</source>
      <title>Google said to buy office buildings for RM1.9bil</title>
      <url>http://my.insideview.com/iv/launchReferredArticle.do?aid=19347156172&amp;cid=736233</url>
   </article>
   <article>
      <agents>ACQUISITIONS</agents>
      <publicationDate>Oct 23, 2014 9:54:00 PM PDT</publicationDate>
      <source>Bloomberg</source>
      <title>Google Said to Buy Redwood City Offices for $585 Million</title>
      <url>http://my.insideview.com/iv/launchReferredArticle.do?aid=19346813726&amp;cid=736233</url>
   </article>
   <article>
      <agents>ACQUISITIONS</agents>
      <publicationDate>Oct 22, 2014 8:52:00 AM PDT</publicationDate>
      <source>Individual.com</source>
      <title>Firebase acquired by Google</title>
      <url>http://my.insideview.com/iv/launchReferredArticle.do?aid=19330083354&amp;cid=736233</url>
   </article>
   <article>
      <agents>ACQUISITIONS</agents>
      <publicationDate>Oct 22, 2014 6:43:00 AM PDT</publicationDate>
      <source>ServicesAngle</source>
      <title>Google buys Firebase to add real-time sync &amp; store capabilities to its Cloud Platform</title>
      <url>http://my.insideview.com/iv/launchReferredArticle.do?aid=19328853169&amp;cid=736233</url>
   </article>
   <article>
      <agents>ACQUISITIONS</agents>
      <publicationDate>Oct 22, 2014 6:38:00 AM PDT</publicationDate>
      <similarNewsCount>3</similarNewsCount>
      <source>Bidness Etc</source>
      <title>Google Acquires Firebase To Shore Up App Development Platform</title>
      <url>http://my.insideview.com/iv/launchReferredArticle.do?aid=19328800188&amp;cid=736233</url>
   </article>
   <article>
      <agents>ACQUISITIONS</agents>
      <publicationDate>Oct 22, 2014 4:37:00 AM PDT</publicationDate>
      <source>Benzinga.com</source>
      <title>Himax Technologies Tumbles; Google Won't Boost Stake</title>
      <url>http://my.insideview.com/iv/launchReferredArticle.do?aid=19327737383&amp;cid=736233</url>
   </article>
   <article>
      <agents>ACQUISITIONS</agents>
      <publicationDate>Oct 21, 2014 10:49:00 AM PDT</publicationDate>
      <similarNewsCount>2</similarNewsCount>
      <source>BusinessWeek</source>
      <title>Google Buys Firebase to Add Cloud-Computing Mobile Tools</title>
      <url>http://my.insideview.com/iv/launchReferredArticle.do?aid=19319789202&amp;cid=736233</url>
   </article>
   <article>
      <agents>LEADERSHIP_CHANGES</agents>
      <publicationDate>Oct 20, 2014 6:45:00 AM PDT</publicationDate>
      <source>SNL Financial</source>
      <title>Report: Google taps Android exec to lead Chrome engineering team</title>
      <url>http://my.insideview.com/iv/launchReferredArticle.do?aid=19306120365&amp;cid=736233</url>
   </article>
   <article>
      <agents>LEADERSHIP_CHANGES</agents>
      <publicationDate>Oct 17, 2014 12:56:00 PM PDT</publicationDate>
      <source>Big News Network</source>
      <title>White House nominates former Google exec to lead US patent office</title>
      <url>http://my.insideview.com/iv/launchReferredArticle.do?aid=19282765680&amp;cid=736233</url>
   </article>
   <page>1</page>
   <resultsPerPage>9</resultsPerPage>
   <totalResults>9</totalResults>
   <companyId>726263</companyId>
   <currentCompanyId>1755</currentCompanyId>
</news>

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.

Articles in this section

[GET] - Company News Agents