Get Sources
GET {{baseUrl}}/v2/sources?lang=en&countries=US,CA&topic=business
Returns a list of the top 100 supported news websites. Overall, we support over 60,000 websites. Using this endpoint, you may find the top 100 for your specific language, country, topic combination.
Request Params
| Key | Datatype | Required | Description |
|---|---|---|---|
lang | string | Specifies the languages of the search. For example: en. |
The only accepted format is ISO 639-1 — 2 letter code.
|
| countries | string | | Countries where the news publisher is located.
Important: This parameter is not responsible for the countries mentioned in the news article.
One or multiple countries can be used in the search.
The only acceptable format is ISO 3166-1 alpha-2
For example, US,CA,MX or just US
|
| topic | string | | Accepted values: news, sport, tech, world, finance, politics, business, economics, entertainment, beauty, travel, music, food, science, gaming, energy
The topic to which you want to restrict the articles of your choice.
Not all news articles are assigned with a topic, therefore, we cannot guarantee that 100% of topics talking about technology will be assigned a tech label. |
RESPONSES
status: OK
{"message":"Maximum sources displayed according to your plan is set to 100","sources":["financialpost.com","businessinsider.com","forbes.com","apnews.com","yahoo.com","sfgate.com","timesunion.com","thetelegraph.com","beaumontenterprise.com","ctpost.com","milfordmirror.com","sfchronicle.com","theintelligencer.com","greenwichtime.com","myjournalcourier.com","newmilfordspectrum.com","newstimes.com","sheltonherald.com","thehour.com","westport-news.com","lmtonline.com","middletownpress.com","nhregister.com","ourmidland.com","registercitizen.com","stamfordadvocate.com","fairfieldcitizenonline.com","seattlepi.com","chron.com","mrt.com","mysanantonio.com","michigansthumb.com","patch.com","myplainview.com","thecourierexpress.com","cnbc.com","theridgefieldpress.com","trumbulltimes.com","wiltonbulletin.com","manisteenews.com","ncadvertiser.com","darientimes.com","youtube.com","bigrapidsnews.com","thedailytimes.com","nasdaq.com","winnipegfreepress.com","bloomberg.com","sandiegouniontribune.com","theglobeandmail.com","washingtonpost.com","google.com","heraldonline.com","sacbee.com","benzinga.com","seekingalpha.com","stltoday.com","digitaljournal.com","bozemandailychronicle.com","reuters.com","timescolonist.com","cnn.com","ctvnews.ca","lawndalenews.com","blackenterprise.com","detroitnews.com","ksat.com","centralillinoisproud.com","click2houston.com","medicinehatnews.com","theolympian.com","bnd.com","kansas.com","ledger-enquirer.com","nbcconnecticut.com","si.com","sunherald.com","thenewstribune.com","tucson.com","bradenton.com","cnbctv18.com","inc.com","marketscreener.com","reddit.com","thenextweb.com","businessjournaldaily.com","businessreport.com","cheatsheet.com","deadline.com","fastcompany.com","foxbusiness.com","fresnobee.com","idahostatesman.com","insidetucsonbusiness.com","masslive.com","nytimes.com","republicworld.com","wkrg.com","wsj.com","billboard.com"],"user_input":{"lang":["en"],"countries":["US","CA"],"topic":"business"}}