Articles in this section

[GET] - Company News Agents

Harry Anthony
  • Updated
Follow

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.
Accept String No

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

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
}

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

 

Related articles

Comments

0 comments

Please sign in to leave a comment.

Powered by Zendesk