[POST] - Company Insights News details API

  • Updated

Use the Company Insights News detail API's endpoint to retrieve article URL of the news for a known article id. This API is used in conjunction with Company Insights News Search API.

 

Endpoint 

 POST https://api.insideview.com/api/v1/target/companies/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).

Form Parameters

Parameter Name Type Required Description
articleIds String Yes A comma-separated list of Article IDs retrieved from Search API. Max:10000

 

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
articleId String Article Id
agentName String Agent Name 
url String Article launcher Url
companyId String Company id

application/json Example

{
  "articles": [
    {
      "articleId": "_BlTPgCruUChHgYmsrHJK80DgsXrUp8K1dtdF6vJlGa2FZOMKBleM6T11xdB2jdfczgM0JtxYlHfyhHa4PGH8w",
      "agentName": "PARTNERSHIPS",
      "url": "http://my.insideview.com/iv/launchReferredArticle.iv?id=26193693424&cid=726263&st=PARTNERSHI...",
      "companyId": "Ff24HpXMDjFXZSAw7mYEo30V60AEfv00tHfZrwPXo5CA-91UMZEPU7O2PW_AN1rF"
    },
    {
      "articleId": "_BlTPgCruUChHgYmsrHJK6BO4NBOcSC4IAbo4-ylhRahZ9xtY9i74nLR2Il4A2vI_z4DFTbPQRUOuvDx7bmFJQ",
      "agentName": "LITIGATION",
      "url": "http://my.insideview.com/iv/launchReferredArticle.iv?id=26200598583&cid=726263&st=LITIGATION...",
      "companyId": "Ff24HpXMDjFXZSAw7mYEo30V60AEfv00tHfZrwPXo5CA-91UMZEPU7O2PW_AN1rF"
    }
  ]
}

application/xml Example

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<articles>
    <article>
        <agentName>PARTNERSHIPS</agentName>
        <articleId>_BlTPgCruUChHgYmsrHJK80DgsXrUp8K1dtdF6vJlGa2FZOMKBleM6T11xdB2jdfczgM0JtxYlHfyhHa4PGH8w</articleId>
        <companyId>Ff24HpXMDjFXZSAw7mYEo30V60AEfv00tHfZrwPXo5CA-91UMZEPU7O2PW_AN1rF</companyId>
        <url>http://my.insideview.com/iv/launchReferredArticle.iv?id=26193693424&amp;cid=726263&amp;st=PARTNERSHIPS&amp;from=api</url>
    </article>
    <article>
        <agentName>LITIGATION</agentName>
        <articleId>_BlTPgCruUChHgYmsrHJK6BO4NBOcSC4IAbo4-ylhRahZ9xtY9i74nLR2Il4A2vI_z4DFTbPQRUOuvDx7bmFJQ</articleId>
        <companyId>Ff24HpXMDjFXZSAw7mYEo30V60AEfv00tHfZrwPXo5CA-91UMZEPU7O2PW_AN1rF</companyId>
        <url>http://my.insideview.com/iv/launchReferredArticle.iv?id=26200598583&amp;cid=726263&amp;st=LITIGATION&amp;from=api</url>
    </article>
</articles>

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.