[GET] - Contact News Feed API

  • Updated

Use the Contact News feed API  to retrieve uncategorized news for a specific contact. Please note that not all contacts have any news associated with them.

 

Endpoint

GET https://api.insideview.com/api/v1/contact/{contactId}/newsFeed

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

URI Parameters

Parameter Name Type Required Description
contactId Integer Yes A valid contact ID

Query Parameters

Parameter Name Type Required Description
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: 20

 

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
contactId String Normal contact Id
contactNews Array  Array of contact news
contactNews  title String  News title
contactNews  url String News URL
contactNews  publicationDate Date Publication date and time (PST) of the article
contactNews  source String Article source
contactNews imageUrl String URL of an image from the article.
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

{
  "contactNews": [
    {
      "title": "Apple Raised to Buy at Piper Jaffray (AAPL)",
      "url": "http://my.insideview.com/iv/launchReferredArticle.do?id=23556674097&aid=23556674097&cid=7244...",
      "publicationDate": "Sat Nov 28 17:36:01 PST 2015",
      "source": "American Banking News - Forex"
    },
    {
      "title": "AAPL Stock: Tim Cook Is Working on Something Big at Apple Inc.",
      "url": "http://my.insideview.com/iv/launchReferredArticle.do?id=23536146393&aid=23536146393&cid=7244...",
      "publicationDate": "Thu Nov 26 20:34:00 PST 2015",
      "source": "Big News Network"
    },
    {
      "title": "Apple Pay in China: experts expect success",
      "url": "http://my.insideview.com/iv/launchReferredArticle.do?id=23524420413&aid=23524420413&cid=7244...",
      "publicationDate": "Wed Nov 25 21:25:12 PST 2015",
      "source": "CHINAdaily USA"
    },
    {
      "title": "Is Apple iPhone Losing Charm?",
      "url": "http://my.insideview.com/iv/launchReferredArticle.do?id=23519541234&aid=23519541234&cid=7244...",
      "publicationDate": "Wed Nov 25 11:42:26 PST 2015",
      "source": "Bidness Etc"
    },
    {
      "title": "Piper Jaffray Upgrades Apple to Buy (AAPL)",
      "url": "http://my.insideview.com/iv/launchReferredArticle.do?id=23518476511&aid=23518476511&cid=7244...",
      "publicationDate": "Wed Nov 25 09:42:34 PST 2015",
      "source": "WKRB News"
    },
    {
      "title": "Wall Street's Week Ahead: Dow Jones Industrial Average Jumps 100 Points, Nasdaq Gains Ahead Of Apple Inc. ‘Spring Forwar",
      "url": "http://my.insideview.com/iv/launchReferredArticle.do?id=23517298277&aid=23517298277&cid=7244...",
      "publicationDate": "Wed Nov 25 07:40:55 PST 2015",
      "source": "MyInforms"
    },
    {
      "title": "Apple Pay will launch in China in February 2016",
      "url": "http://my.insideview.com/iv/launchReferredArticle.do?id=23515598631&aid=23515598631&cid=7244...",
      "publicationDate": "Wed Nov 25 04:48:08 PST 2015",
      "source": "International Business Times Australia"
    },
    {
      "title": "Bidness Etc Exclusive: Hands-On With Apple iPad Pro 12.9\"",
      "url": "http://my.insideview.com/iv/launchReferredArticle.do?id=23515280480&aid=23515280480&cid=7244...",
      "publicationDate": "Wed Nov 25 04:17:20 PST 2015",
      "source": "Bidness Etc"
    },
    {
      "title": "Pictured is Apple's Logo at their Tianjin Store",
      "url": "http://my.insideview.com/iv/launchReferredArticle.do?id=23512875518&aid=23512875518&cid=7244...",
      "publicationDate": "Wed Nov 25 00:04:52 PST 2015",
      "source": "Mobile & Apps"
    },
    {
      "title": "Piper Jaffray Reiterates Overweight Rating for Apple (AAPL)",
      "url": "http://my.insideview.com/iv/launchReferredArticle.do?id=23509582254&aid=23509582254&cid=7244...",
      "publicationDate": "Tue Nov 24 17:01:39 PST 2015",
      "source": "American Banking News - Forex"
    },
    {
      "title": "Piper Jaffray Reiterates Overweight Rating for Apple (AAPL)",
      "url": "http://my.insideview.com/iv/launchReferredArticle.do?id=23509570107&aid=23509570107&cid=7244...",
      "publicationDate": "Tue Nov 24 17:00:26 PST 2015",
      "source": "American Banking News"
    },
    {
      "title": "RBC Capital Reiterates “Buy” Rating for Apple (AAPL)",
      "url": "http://my.insideview.com/iv/launchReferredArticle.do?id=23506442022&aid=23506442022&cid=7244...",
      "publicationDate": "Tue Nov 24 11:21:16 PST 2015",
      "source": "American Banking News"
    },
    {
      "title": "Apple Pay To Cash In On Growing Chinese Digital Payments Market In 2016",
      "url": "http://my.insideview.com/iv/launchReferredArticle.do?id=23506239126&aid=23506239126&cid=7244...",
      "publicationDate": "Tue Nov 24 10:59:44 PST 2015",
      "source": "Bidness Etc"
    },
    {
      "title": "Here's the secret way to hide the iPhone apps that Apple won't let you delete (AAPL)",
      "url": "http://my.insideview.com/iv/launchReferredArticle.do?id=23504411610&aid=23504411610&cid=7244...",
      "publicationDate": "Tue Nov 24 08:05:46 PST 2015",
      "source": "E-Servicis.com",
      "imageUrl": "http://static.e-servicis.com/i/46/27/300eeee8061d901c3736e320ab5a.jpg"
    },
    {
      "title": "Here's the secret way to hide the iPhone apps that Apple doesn't let you delete",
      "url": "http://my.insideview.com/iv/launchReferredArticle.do?id=23503661468&aid=23503661468&cid=7244...",
      "publicationDate": "Tue Nov 24 06:55:16 PST 2015",
      "source": "Business Insider",
      "imageUrl": "http://static5.businessinsider.com/image/54dddf4ddd089567228b4617/heres-the-secret-way-to-hide-the-i..."
    },
    {
      "title": "Here’s the secret way to hide the iPhone apps that Apple doesn’t let you delete",
      "url": "http://my.insideview.com/iv/launchReferredArticle.do?id=23503660281&aid=23503660281&cid=7244...",
      "publicationDate": "Tue Nov 24 06:55:09 PST 2015",
      "source": "Business Insider Malaysia",
      "imageUrl": "https://static-ssl.businessinsider.com/image/56533b62dd089512058b469b-1440-1080/iphone_1.png"
    },
    {
      "title": "Apple seeks to launch Apple Pay in China by February",
      "url": "http://my.insideview.com/iv/launchReferredArticle.do?id=23502714958&aid=23502714958&cid=7244...",
      "publicationDate": "Tue Nov 24 05:26:32 PST 2015",
      "source": "Mac Daily News"
    },
    {
      "title": "Apple Pay Aims to Launch in China by Early February -- Update",
      "url": "http://my.insideview.com/iv/launchReferredArticle.do?id=23501910687&aid=23501910687&cid=724468",
      "publicationDate": "Tue Nov 24 04:08:41 PST 2015",
      "source": "4 Traders"
    },
    {
      "title": "Are users hungry enough for NFC?",
      "url": "http://my.insideview.com/iv/launchReferredArticle.do?id=23496577751&aid=23496577751&cid=724468",
      "publicationDate": "Mon Nov 23 17:54:14 PST 2015",
      "source": "HT Syndication"
    },
    {
      "title": "CPBJ Extra Blog: York College student's winning elevator pitch draws interest from Apple",
      "url": "http://my.insideview.com/iv/launchReferredArticle.do?id=23490115070&aid=23490115070&cid=724468",
      "publicationDate": "Mon Nov 23 06:40:18 PST 2015",
      "source": "Central Penn Business Journal"
    }
  ],
  "page": 1,
  "resultsPerPage": 20,
  "totalResults": 216,
  "contactId": "225"
}

application/xml Example

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<news>
    <contactId>225</contactId>
    <article>
        <publicationDate>Sat Nov 28 17:36:01 PST 2015</publicationDate>
        <source>American Banking News - Forex</source>
        <title>Apple Raised to Buy at Piper Jaffray (AAPL)</title>
        <url>http://my.insideview.com/iv/launchReferredArticle.do?id=23556674097&amp;aid=23556674097&amp;...>
    </article>
    <article>
        <publicationDate>Thu Nov 26 20:34:00 PST 2015</publicationDate>
        <source>Big News Network</source>
        <title>AAPL Stock: Tim Cook Is Working on Something Big at Apple Inc.</title>
        <url>http://my.insideview.com/iv/launchReferredArticle.do?id=23536146393&amp;aid=23536146393&amp;...>
    </article>
    <article>
        <publicationDate>Wed Nov 25 21:25:12 PST 2015</publicationDate>
        <source>CHINAdaily USA</source>
        <title>Apple Pay in China: experts expect success</title>
        <url>http://my.insideview.com/iv/launchReferredArticle.do?id=23524420413&amp;aid=23524420413&amp;...>
    </article>
    <article>
        <publicationDate>Wed Nov 25 11:42:26 PST 2015</publicationDate>
        <source>Bidness Etc</source>
        <title>Is Apple iPhone Losing Charm?</title>
        <url>http://my.insideview.com/iv/launchReferredArticle.do?id=23519541234&amp;aid=23519541234&amp;...>
    </article>
    <article>
        <publicationDate>Wed Nov 25 09:42:34 PST 2015</publicationDate>
        <source>WKRB News</source>
        <title>Piper Jaffray Upgrades Apple to Buy (AAPL)</title>
        <url>http://my.insideview.com/iv/launchReferredArticle.do?id=23518476511&amp;aid=23518476511&amp;...>
    </article>
    <article>
        <publicationDate>Wed Nov 25 07:40:55 PST 2015</publicationDate>
        <source>MyInforms</source>
        <title>Wall Street's Week Ahead: Dow Jones Industrial Average Jumps 100 Points, Nasdaq Gains Ahead Of Apple Inc. ‘Spring Forwar</title>
        <url>http://my.insideview.com/iv/launchReferredArticle.do?id=23517298277&amp;aid=23517298277&amp;...>
    </article>
    <article>
        <publicationDate>Wed Nov 25 04:48:08 PST 2015</publicationDate>
        <source>International Business Times Australia</source>
        <title>Apple Pay will launch in China in February 2016</title>
        <url>http://my.insideview.com/iv/launchReferredArticle.do?id=23515598631&amp;aid=23515598631&amp;...>
    </article>
    <article>
        <publicationDate>Wed Nov 25 04:17:20 PST 2015</publicationDate>
        <source>Bidness Etc</source>
        <title>Bidness Etc Exclusive: Hands-On With Apple iPad Pro 12.9"</title>
        <url>http://my.insideview.com/iv/launchReferredArticle.do?id=23515280480&amp;aid=23515280480&amp;...>
    </article>
    <article>
        <publicationDate>Wed Nov 25 00:04:52 PST 2015</publicationDate>
        <source>Mobile &amp; Apps</source>
        <title>Pictured is Apple's Logo at their Tianjin Store</title>
        <url>http://my.insideview.com/iv/launchReferredArticle.do?id=23512875518&amp;aid=23512875518&amp;...>
    </article>
    <article>
        <publicationDate>Tue Nov 24 17:01:39 PST 2015</publicationDate>
        <source>American Banking News - Forex</source>
        <title>Piper Jaffray Reiterates Overweight Rating for Apple (AAPL)</title>
        <url>http://my.insideview.com/iv/launchReferredArticle.do?id=23509582254&amp;aid=23509582254&amp;...>
    </article>
    <article>
        <publicationDate>Tue Nov 24 17:00:26 PST 2015</publicationDate>
        <source>American Banking News</source>
        <title>Piper Jaffray Reiterates Overweight Rating for Apple (AAPL)</title>
        <url>http://my.insideview.com/iv/launchReferredArticle.do?id=23509570107&amp;aid=23509570107&amp;...>
    </article>
    <article>
        <publicationDate>Tue Nov 24 11:21:16 PST 2015</publicationDate>
        <source>American Banking News</source>
        <title>RBC Capital Reiterates “Buy” Rating for Apple (AAPL)</title>
        <url>http://my.insideview.com/iv/launchReferredArticle.do?id=23506442022&amp;aid=23506442022&amp;...>
    </article>
    <article>
        <publicationDate>Tue Nov 24 10:59:44 PST 2015</publicationDate>
        <source>Bidness Etc</source>
        <title>Apple Pay To Cash In On Growing Chinese Digital Payments Market In 2016</title>
        <url>http://my.insideview.com/iv/launchReferredArticle.do?id=23506239126&amp;aid=23506239126&amp;...>
    </article>
    <article>
        <imageUrl>http://static.e-servicis.com/i/46/27/300eeee8061d901c3736e320ab5a.jpg</imageUrl>
        <publicationDate>Tue Nov 24 08:05:46 PST 2015</publicationDate>
        <source>E-Servicis.com</source>
        <title>Here's the secret way to hide the iPhone apps that Apple won't let you delete (AAPL)</title>
        <url>http://my.insideview.com/iv/launchReferredArticle.do?id=23504411610&amp;aid=23504411610&amp;...>
    </article>
    <article>
        <imageUrl>http://static5.businessinsider.com/image/54dddf4ddd089567228b4617/heres-the-secret-way-to-hide-the-i...>
        <publicationDate>Tue Nov 24 06:55:16 PST 2015</publicationDate>
        <source>Business Insider</source>
        <title>Here's the secret way to hide the iPhone apps that Apple doesn't let you delete</title>
        <url>http://my.insideview.com/iv/launchReferredArticle.do?id=23503661468&amp;aid=23503661468&amp;...>
    </article>
    <article>
        <imageUrl>https://static-ssl.businessinsider.com/image/56533b62dd089512058b469b-1440-1080/iphone_1.png</ima...>
        <publicationDate>Tue Nov 24 06:55:09 PST 2015</publicationDate>
        <source>Business Insider Malaysia</source>
        <title>Here’s the secret way to hide the iPhone apps that Apple doesn’t let you delete</title>
        <url>http://my.insideview.com/iv/launchReferredArticle.do?id=23503660281&amp;aid=23503660281&amp;...>
    </article>
    <article>
        <publicationDate>Tue Nov 24 05:26:32 PST 2015</publicationDate>
        <source>Mac Daily News</source>
        <title>Apple seeks to launch Apple Pay in China by February</title>
        <url>http://my.insideview.com/iv/launchReferredArticle.do?id=23502714958&amp;aid=23502714958&amp;...>
    </article>
    <article>
        <publicationDate>Tue Nov 24 04:08:41 PST 2015</publicationDate>
        <source>4 Traders</source>
        <title>Apple Pay Aims to Launch in China by Early February -- Update</title>
        <url>http://my.insideview.com/iv/launchReferredArticle.do?id=23501910687&amp;aid=23501910687&amp;cid=724468</url>
    </article>
    <article>
        <publicationDate>Mon Nov 23 17:54:14 PST 2015</publicationDate>
        <source>HT Syndication</source>
        <title>Are users hungry enough for NFC?</title>
        <url>http://my.insideview.com/iv/launchReferredArticle.do?id=23496577751&amp;aid=23496577751&amp;cid=724468</url>
    </article>
    <article>
        <publicationDate>Mon Nov 23 06:40:18 PST 2015</publicationDate>
        <source>Central Penn Business Journal</source>
        <title>CPBJ Extra Blog: York College student's winning elevator pitch draws interest from Apple</title>
        <url>http://my.insideview.com/iv/launchReferredArticle.do?id=23490115070&amp;aid=23490115070&amp;cid=724468</url>
    </article>
    <page>1</page>
    <resultsPerPage>20</resultsPerPage>
    <totalResults>216</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.