Sources

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.

Get Sources

GET https://api.newscatcherapi.com/v2/sources?topic=business&lang=en&countries=US

Get top news sources supported by NewsCatcher.

Query Parameters

Name	Type	Description
lang	array	Specifies the languages of the search. For example, en. The only accepted format is ISO 639-1 — 2 letter code. Refer to the Allowed Languages section for more details.
countries	array	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.

Headers

Name	Type	Description
x-api-key	string	Your unique authentication token

200 Success

{
    "message": "Maximum sources displayed according to your plan is set to 100",
    "sources": [
        "businessinsider.com",
        "forbes.com",
        "apnews.com",
        "yahoo.com",
        "newstimes.com",
        "timesunion.com",
        "ourmidland.com",
        "stamfordadvocate.com",
        "thetelegraph.com",
        "fairfieldcitizenonline.com",
        "newmilfordspectrum.com",
        "nhregister.com",
        "sfchronicle.com",
        "sheltonherald.com",
        "greenwichtime.com",
        "seattlepi.com",
        "sfgate.com",
        "westport-news.com",
        "myjournalcourier.com",
        "registercitizen.com",
        "theintelligencer.com",
        "beaumontenterprise.com",
        "ctpost.com",
        "lmtonline.com",
        "middletownpress.com",
        "mrt.com",
        "thehour.com",
        "chron.com",
        "michigansthumb.com",
        "milfordmirror.com",
        "mysanantonio.com",
        "thecourierexpress.com",
        "cnbc.com",
        "thedailytimes.com",
        "myplainview.com",
        "wiltonbulletin.com",
        "theridgefieldpress.com",
        "bigrapidsnews.com",
        "manisteenews.com",
        "ncadvertiser.com",
        "trumbulltimes.com",
        "google.com",
        "sandiegouniontribune.com",
        "youtube.com",
        "si.com",
        "yardbarker.com",
        "nasdaq.com",
        "bloomberg.com",
        "bozemandailychronicle.com",
        "reuters.com",
        "blackenterprise.com",
        "seekingalpha.com",
        "stltoday.com",
        "cbs42.com",
        "reddit.com",
        "detroitnews.com",
        "wric.com",
        "washingtonpost.com",
        "benzinga.com",
        "inc.com",
        "sacbee.com",
        "timescolonist.com",
        "muscatinejournal.com",
        "businessreport.com",
        "click2houston.com",
        "deadline.com",
        "ksat.com",
        "marketscreener.com",
        "tapinto.net",
        "tucson.com",
        "bradenton.com",
        "cheatsheet.com",
        "cnn.com",
        "darientimes.com",
        "nbcconnecticut.com",
        "patch.com",
        "tri-cityherald.com",
        "billboard.com",
        "businessjournaldaily.com",
        "coindesk.com",
        "fastcompany.com",
        "fortune.com",
        "foxbusiness.com",
        "heraldonline.com",
        "khn.org",
        "nbcnewyork.com",
        "news24.com",
        "nytimes.com",
        "techcrunch.com",
        "thenewstribune.com",
        "thenextweb.com",
        "argusleader.com",
        "bizjournals.com",
        "brinkwire.com",
        "cbslocal.com",
        "kansas.com",
        "looper.com",
        "news4jax.com",
        "republicworld.com",
        "americanbankingnews.com"
    ],
    "user_input": {
        "lang": [
            "en"
        ],
        "countries": [
            "US"
        ],
        "topic": "business"
    }
}

400: Bad Request API Call without "x-api-key" in headers

{
    "status": "error",
    "error_code": "HeadersWithoutKey",
    "message": "No API key was given. Please provide an API key and put it into headers, like 'x-api-key': 'YOUR_API_KEY'"
}

401: Unauthorized Invalid API Key

{
    "status": "error",
    "error_code": "InvalidAPIKey",
    "message": "Invalid api key: false_api_key"
}

406: Not Acceptable Unsupported Parameters

{
    "status": "error",
    "error_code": "UnsupportedParameter",
    "message": "Found unsupported parameter(s)['sort_by', 'q']. Here are the parameters available for this endpoint => ['countries', 'topic', 'lang']"
}

408: Request Timeout Request Timeout

{
    "status": "error",
    "error_code": "UnsupportedParameter",
    "message": "Request takes more than 30 seconds. Your search is too broad.Try to use more parameters to narrow down the request."
}

429: Too Many Requests Too many API calls

{
  "status": "error",
  "error_code": "ConcurrencyViolation",
  "message": "Max concurrency allowed 1 per 1 second"
}

Get Sources

POST https://api.newscatcherapi.com/v2/sources

Get top news sources supported by NewsCatcher.

Query Parameters

Name	Type	Description
lang	array	Specifies the languages of the search. For example, en. The only accepted format is ISO 639-1 — 2 letter code. Refer to the Allowed Languages section for more details.
countries	array	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.

Headers

Name	Type	Description
x-api-key	string	Your unique authentication token

200 Success

{
    "message": "Maximum sources displayed according to your plan is set to 100",
    "sources": [
        "businessinsider.com",
        "forbes.com",
        "apnews.com",
        "yahoo.com",
        "newstimes.com",
        "timesunion.com",
        "ourmidland.com",
        "stamfordadvocate.com",
        "thetelegraph.com",
        "fairfieldcitizenonline.com",
        "newmilfordspectrum.com",
        "nhregister.com",
        "sfchronicle.com",
        "sheltonherald.com",
        "greenwichtime.com",
        "seattlepi.com",
        "sfgate.com",
        "westport-news.com",
        "myjournalcourier.com",
        "registercitizen.com",
        "theintelligencer.com",
        "beaumontenterprise.com",
        "ctpost.com",
        "lmtonline.com",
        "middletownpress.com",
        "mrt.com",
        "thehour.com",
        "chron.com",
        "michigansthumb.com",
        "milfordmirror.com",
        "mysanantonio.com",
        "thecourierexpress.com",
        "cnbc.com",
        "thedailytimes.com",
        "myplainview.com",
        "wiltonbulletin.com",
        "theridgefieldpress.com",
        "bigrapidsnews.com",
        "manisteenews.com",
        "ncadvertiser.com",
        "trumbulltimes.com",
        "google.com",
        "sandiegouniontribune.com",
        "youtube.com",
        "si.com",
        "yardbarker.com",
        "nasdaq.com",
        "bloomberg.com",
        "bozemandailychronicle.com",
        "reuters.com",
        "blackenterprise.com",
        "seekingalpha.com",
        "stltoday.com",
        "cbs42.com",
        "reddit.com",
        "detroitnews.com",
        "wric.com",
        "washingtonpost.com",
        "benzinga.com",
        "inc.com",
        "sacbee.com",
        "timescolonist.com",
        "muscatinejournal.com",
        "businessreport.com",
        "click2houston.com",
        "deadline.com",
        "ksat.com",
        "marketscreener.com",
        "tapinto.net",
        "tucson.com",
        "bradenton.com",
        "cheatsheet.com",
        "cnn.com",
        "darientimes.com",
        "nbcconnecticut.com",
        "patch.com",
        "tri-cityherald.com",
        "billboard.com",
        "businessjournaldaily.com",
        "coindesk.com",
        "fastcompany.com",
        "fortune.com",
        "foxbusiness.com",
        "heraldonline.com",
        "khn.org",
        "nbcnewyork.com",
        "news24.com",
        "nytimes.com",
        "techcrunch.com",
        "thenewstribune.com",
        "thenextweb.com",
        "argusleader.com",
        "bizjournals.com",
        "brinkwire.com",
        "cbslocal.com",
        "kansas.com",
        "looper.com",
        "news4jax.com",
        "republicworld.com",
        "americanbankingnews.com"
    ],
    "user_input": {
        "lang": [
            "en"
        ],
        "countries": [
            "US"
        ],
        "topic": "business"
    }
}

400: Bad Request API Call without "x-api-key" in headers

{
    "status": "error",
    "error_code": "HeadersWithoutKey",
    "message": "No API key was given. Please provide an API key and put it into headers, like 'x-api-key': 'YOUR_API_KEY'"
}

401: Unauthorized Invalid API Key

{
    "status": "error",
    "error_code": "InvalidAPIKey",
    "message": "Invalid api key: false_api_key"
}

406: Not Acceptable Unsupported Parameters

{
    "status": "error",
    "error_code": "UnsupportedParameter",
    "message": "Found unsupported parameter(s)['sort_by', 'q']. Here are the parameters available for this endpoint => ['countries', 'topic', 'lang']"
}

408: Request Timeout Request Timeout

{
    "status": "error",
    "error_code": "UnsupportedParameter",
    "message": "Request takes more than 30 seconds. Your search is too broad.Try to use more parameters to narrow down the request."
}

429: Too Many Requests Too many API calls

{
  "status": "error",
  "error_code": "ConcurrencyViolation",
  "message": "Max concurrency allowed 1 per 1 second"
}

Successful Request Response

{'message': 'Maximum sources displayed according to your plan is set to 100',
 'sources': ['alpenhornnews.com',
  'forbes.com',
  'businessinsider.com',
  'prnewswire.com',
  'einpresswire.com',
  'greenwichtime.com',
  'sfchronicle.com',
  'sfgate.com',
  'theintelligencer.com',
  'lakecountystar.com',
  'mrt.com',
  'sheltonherald.com',
  'lmtonline.com',
  'milfordmirror.com',
  'newstimes.com',
  'thetelegraph.com',
  'beaumontenterprise.com',
  'benzinga.com',
  'middletownpress.com',
  'ctpost.com',
  'nhregister.com',
  'thehour.com',
  'timesunion.com',
  'michigansthumb.com',
  'ourmidland.com',
  'registercitizen.com',
  'stamfordadvocate.com',
  'myjournalcourier.com',
  'seattlepi.com',
  'mysanantonio.com',
  'chron.com',
  'yahoo.com',
  'fortune.com',
  'seattletimes.com',
  'wiltonbulletin.com',
  'trumbulltimes.com',
  'theridgefieldpress.com',
  'apnews.com',
  'khon2.com',
  'kxan.com',
  'bigrapidsnews.com',
  'darientimes.com',
  'wric.com',
  'legacy.com',
  'ncadvertiser.com',
  'bloomberg.com',
  'click2houston.com',
  'compsmag.com',
  'pahomepage.com',
  'houstonchronicle.com',
  'ksn.com',
  'sandiegouniontribune.com',
  'theheraldreview.com',
  'wgno.com',
  'cnn.com',
  'fox4kc.com',
  'ksat.com',
  '8newsnow.com',
  'blackenterprise.com',
  'cbs42.com',
  'fastcompany.com',
  'myplainview.com',
  'ourquadcities.com',
  'wjbf.com',
  'cnbc.com',
  'manisteenews.com',
  'wbtw.com',
  'wnct.com',
  'businessjournaldaily.com',
  'businessrecord.com',
  'conchovalleyhomepage.com',
  'globenewswire.com',
  'inc.com',
  'movieweb.com',
  'mychamplainvalley.com',
  'seekingalpha.com',
  'wboy.com',
  'wearegreenbay.com',
  'wjhl.com',
  'wspa.com',
  'abc4.com',
  'businessreport.com',
  'clickondetroit.com',
  'swoknews.com',
  'wcia.com',
  'broadwayworld.com',
  'coindesk.com',
  'fourstateshomepage.com',
  'fox40.com',
  'kfor.com',
  'kget.com',
  'kxnet.com',
  'latimes.com',
  'tastingtable.com',
  'wgnradio.com',
  'wpri.com',
  'yourcentralvalley.com',
  'clarksvillenow.com',
  'deadline.com',
  'expressnews.com'],
 'user_input': {'lang': ['en'], 'countries': ['US'], 'topic': 'business'}}