You can use API Feed Manager to automatically generate the URI request that you can use with your client to pull your feed. The API will provide a URI with your 'client_id', 'secret" and all configurable options. The interface can be accessed at https://www.newslookup.com/api_feed_manager.php . You must have an account and be logged-in to access the API Feed Manager.
Here’s an example of an API request:
URI Format: HTTP GET https://api.newslookup.com/feed/package?client_id=your key&secret=your secret
The variables below provide the manual API settings.
Required Auth Variables (provided at time of free trial and paid subscription sign-up)
client_id : Your unique 'client id'. secret : Your unique 'secret'.
See the 'Subscriptions' link from your Profile menu for your API credentials. Available packages and filters are listed in the tables below. The 'live' real time crawler index access package contains all packages combined except for press releases. See subscription level for availability of formats and filters.
Package Names and Descriptions
live : Live real time access to crawler index. daily : All prior day data. hourly : Last hour data. business : Business news. entertainment : Entertainment news. health : Health news. politics : US Political News. science : Science. tech : Technology (IT/Tech). wires : News agencies feed. worldtv : International TV news outlets world-wide. africa : Africa. eastasia : Asia - East Asia. southeastasia : Asia - South East Asia. southasia : Asia - South Asia. europe : Europe. mideast : Middle East. canada : Canada. usnews : US Newspapers/TV/Radio (non national). ustv : US National TV News. usnp : US National Newspapers. au : Australia. nz : New Zealand. pr : Press Releases feed.
Display Settings:
fmt : Field Format
: 0 = Default. Provides article title, link, description, category, publication date, site url/name and article ID.
: 1 = Above items with meta keywords, meta description, referrer link and geo region id(s).
: 2 = Above items with article words extract. 3 = All of the above and link to cached copy. <
: Note: fields returned are dependent on availability in article source.
id : To optimize performance and reduce bandwidth, retrieve records greater than this record id.
limit : Limit the amount of records returned.
output : Defaults to XML, accepts json and sql.
Optional Filters
Media Type : 1 = Internet.
: 2 = Magazine.
: 3 = News Agencies.
: 4 = Newspapers.
: 5 = Radio.
: 6 = Television.
subject : 13 = Business.
: 4 = Commentary.
: 23 = Crypto Currencies.
: 7 = Entertainment.
: 18 = Environment.
: 16 = Health.
: 17 = Internet: Domain Names .
: 14 = IT.
: 11 = Lead Headline.
: 21 = Libraries/Archives.
: 2 = Local News.
: 10 = National News
: 3 = Politics.
: 15 = Press Releases.
: 20 = Radio.
: 9 = Science.
: 6 = Sports.
: 22 = Tech:Network Security.
: 5 = Technology.
: 8 = Travel.
: 1 = World News.
politics : Currently assigned only for select US political sites.
: 9 = Communist.
: 1 = Conservative.
: 2 = Democrat.
: 13 = Leans Left.
: 12 = Leans Right.
: 4 = Liberal.
: 3 = Libertarianism.
: 5 = Neo-Conservative.
: 11 = Non-Partisan.
: 10 = Paleo-Conservative.
: 6 = Progressive.
: 7 = Republican.
: 8 = Socialist.
site_id : Site group ID. See downloads for a list of site group IDs.
Returned XML Data
language : package : Selected feed language. timestamp : Request date in UTC in RFC 2822 format. Example: Fri, 17 Jan 2014 00:25:10 +0000. status : Responses: "success" or "error" code : http status codes : 200 = OK. : 400 = Bad Request. You passed invalid package or filter parameters. : 401 = Not Authorized. You did not provide a valid client_id or secret_id or you are not authorized to use requested filter or package. : 403 = Forbidden. You exceeded the allowable number of API queries for your subscription. : 404 = Not Found. URL or format is incorrect. : 500 = Database temporarily unavailable. message : Informational warning message. Example: "no results". count : Total number of articles returned. format : Your format, if requested other than default. limit : Your limit, if requested. media_type : Media type by name, if requested. politics : Political classification, if requested. subject : Subject by name, if requested. site url : Site URL and Site Name, if requested. ttl : Time to live. The number of minutes that indicates how long your client should cache the response before making the request again. title : Article title. link : Article link. description : If available. category : Article category, if available. region : Sites are assigned to multiple region codes. There are over 100,000 region codes assigned that are available for download. . : However the API currently only supports downloading top level regions as a whole. referrer : URL referrer page where original link was found. pubdate : Article date in UTC in RFC 2822 format. Example: Fri, 17 Jan 2014 00:25:10 +0000. source url= : Site URL and Site Name. meta_keywords : Article meta keywords, if available. meta_description : Article meta description, if available. words : Extract of all words from this link. id : Our article ID. cached : Link to cached copy on our server.