[GET] - Company Insights News Search API

  • Updated

Use the Company Insights News API's endpoint to retrieve categorized news for a specific company. This endpoint behaves similar to Insights News API but this is a search endpoint based on the agents.

 

Endpoint

GET https://api.insideview.com/api/v1/target/companies/{newCompanyId}/insights/news

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.news.search.beta+json, application/api.news.search.beta+xml

URI Parameters

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

Query Parameters

Parameter Name Type Required Description
startTime String ( ISO format) No Start time is ISO format ex. 

2016-03-05T22:49:05
endTime String ( ISO format) No  End time is ISO format ex. 

2016-03-05T22:49:05
agents String No 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: 500, Default: 100

 

 

Agent Name ID
Default All agents ALL
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, see API Error Codes.

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  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)
companyNews articleId String Scrambled article Id
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": "Omantel partners with Microsoft",
      "publicationDate": "2016-04-03T10:17:04.000-07:00",
      "source": "Oman Observer",
      "agents": "PARTNERSHIPS",
      "articleId": "_BlTPgCruUChHgYmsrHJK4MgeQkAbBTMCPBH2etEv0GGPonm_2qJ4d_dos42px8poMLJooD84hFjXRuoE82T8Q"
    },
    {
      "title": "Saudi Arabia planning for the top of the oil age by making a $2 TRILLION funding fund which might be large enough to purchase Google, Apple and Microsoft",
      "publicationDate": "2016-04-02T08:27:33.000-07:00",
      "source": "9ija News.com",
      "agents": "FUNDING_DEVELOPMENTS",
      "imageUrl": "http://i2.wp.com/www.9ijanews.com/wp-content/uploads/2016/04/32BF5D9D00000578-3519536-Deputy_Crown_P...",
      "articleId": "_BlTPgCruUChHgYmsrHJKy3ItW6msXFk4nsdd-hTVfM75OULrN8D4gqgkImgUTiKskdTK_yHpUmh3eSYt3D-Cg"
    },
    {
      "title": "Saudi Arabia planning for the end of the oil age by creating a $2 TRILLION investment fund which would be big enough to buy Google, Apple and Microsoft.",
      "publicationDate": "2016-04-02T02:19:55.000-07:00",
      "source": "NewsGrio",
      "agents": "ACQUISITIONS",
      "imageUrl": "http://www.newsgrio.com/thumbnail.php?file=arb_604402734.jpg&size=article_medium",
      "articleId": "_BlTPgCruUChHgYmsrHJK0gGY2nPOm_CYL74npjGJ5R8RPqCW2N1BV4LPbSdZE-EJOi04olb5N-FaryJTJMtiQ"
    }
  ],
  "page": 1,
  "resultsPerPage": 3,
  "totalResults": 3,
  "companyId": "Ff24HpXMDjFXZSAw7mYEo30V60AEfv00tHfZrwPXo5CA-91UMZEPU7O2PW_AN1rF",
  "startTime": "2016-04-01T22:49:05.000-07:00",
  "endTime": "2016-04-03T22:49:05.000-07:00",
  "agents": "ALL"
}

application/xml Example

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<news>
    <articles>
        <article>
            <agents>PARTNERSHIPS</agents>
            <articleId>_BlTPgCruUChHgYmsrHJK4MgeQkAbBTMCPBH2etEv0GGPonm_2qJ4d_dos42px8poMLJooD84hFjXRuoE82T8Q</articleId>
            <publicationDate>2016-04-03T10:17:04.000-07:00</publicationDate>
            <source>Oman Observer</source>
            <summary></summary>
            <title>Omantel partners with Microsoft</title>
        </article>
        <article>
            <agents>FUNDING_DEVELOPMENTS</agents>
            <articleId>_BlTPgCruUChHgYmsrHJKy3ItW6msXFk4nsdd-hTVfM75OULrN8D4gqgkImgUTiKskdTK_yHpUmh3eSYt3D-Cg</articleId>
            <imageUrl>http://i2.wp.com/www.9ijanews.com/wp-content/uploads/2016/04/32BF5D9D00000578-3519536-Deputy_Crown_Prince_Mohammed_bin_Salman_oversees_the_Public_Inve-m-26_1459538670825.jpg?resize=306%2C330</imageUrl>
            <publicationDate>2016-04-02T08:27:33.000-07:00</publicationDate>
            <source>9ija News.com</source>
            <summary></summary>
            <title>Saudi Arabia planning for the top of the oil age by making a $2 TRILLION funding fund which might be large enough to purchase Google, Apple and Microsoft</title>
        </article>
        <article>
            <agents>ACQUISITIONS</agents>
            <articleId>_BlTPgCruUChHgYmsrHJK0gGY2nPOm_CYL74npjGJ5R8RPqCW2N1BV4LPbSdZE-EJOi04olb5N-FaryJTJMtiQ</articleId>
            <imageUrl>http://www.newsgrio.com/thumbnail.php?file=arb_604402734.jpg&amp;size=article_medium</imageUrl>
            <publicationDate>2016-04-02T02:19:55.000-07:00</publicationDate>
            <source>NewsGrio</source>
            <summary></summary>
            <title>Saudi Arabia planning for the end of the oil age by creating a $2 TRILLION investment fund which would be big enough to buy Google, Apple and Microsoft.</title>
        </article>
    </articles>
    <agents>ALL</agents>
    <companyId>Ff24HpXMDjFXZSAw7mYEo30V60AEfv00tHfZrwPXo5CA-91UMZEPU7O2PW_AN1rF</companyId>
    <endTime>2016-04-03T22:49:05.000-07:00</endTime>
    <page>1</page>
    <resultsPerPage>3</resultsPerPage>
    <startTime>2016-04-01T22:49:05.000-07:00</startTime>
    <totalResults>3</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.