Search News

Main endpoint that allows you to find news article by keyword, date, language, country, etc.

Get News

GET https://api.newscatcherapi.com/v2/search?q=Apple&from=2021/12/15&countries=CA&page_size=1

Query Parameters

Name	Type	Description
q*	string	Keyword/keywords you're searching for. This is the most important part of your query. You can set this to '*' if you don't want to look for specific keywords. Please, refer to the Advanced Query Parameter section below for more examples and explanations.
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 language format section below for more details.
not_lang	array	Inverse to the lang parameter
published_date_precision	string	There are 3 types of date precision we define: full — day and time of an article is correctly identified with the appropriate timezone timezone unknown — day and time of an article is correctly identified without timezone date — only the day is identified without an exact time
search_in	string	By default, we search what you specified in the q parameter in both title and summary of the article. However, you can limit this to either title or summary
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
not_countries	array	The inverse of the countries parameter.
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.
sources	array	One or more news resources to filter your search. It should be the normal form of the URL, For example, nytimes.com,theguardian.com
not_sources	array	One or more sources to be excluded from the search. Comma-separated list. For example, cnn.com,wsj.com
ranked_only	boolean	Default: True Limit the search only for the sources which are in the top 1 million online websites. Unranked sources are assigned a rank that equals 999999
from_rank	integer	[0:999999] The lowest boundary of the rank of a news website to filter by. Important: lower rank means that a source is more popular
to_rank	integer	[0:999999] The upper boundary of the rank of a news website to filter by.
sort_by	string	relevancy (default value) — the most relevant results first date — the most recently published results first rank — the results from the highest-ranked sources first
page_size	integer	[1:100] How many articles to return per page.
page	integer	The number of the page. Use it to scroll through the results. This parameter is used to paginate: scroll through results because one API response cannot return more than 100 articles.
to	string	Until which point in time to search for. The default timezone is UTC. Availabe formats : YYYY/mm/dd YYYY/mm/dd HH:MM:SS English phrases like1 day ago
from	string	From which point in time to start the search. Defaults to the past week. Availabe formats : YYYY/mm/dd YYYY/mm/dd HH:MM:SS English phrases like 1 day ago

Headers

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

200 Success

{
    "status": "ok",
    "total_hits": 10000,
    "page": 1,
    "total_pages": 5000,
    "page_size": 2,
    "articles": [
        {
            "title": "ARK reduziert Anteile: Cathie Wood wirft Tesla-Aktien aus dem Depot",
            "author": null,
            "published_date": "2021-08-04 01:15:00",
            "published_date_precision": "full",
            "link": "https://www.finanzen.net/nachricht/aktien/beteiligung-reduziert-ark-reduziert-anteile-cathie-wood-wirft-tesla-aktien-aus-dem-depot-10402608",
            "clean_url": "finanzen.net",
            "excerpt": "• ARK Invest verkauft Tesla-Anteile im Wert von 43,7 Millionen US-Dollar • Tesla-Aktie bleibt Top-Holding in drei ETFs • Cathie Wood sieht Tesla-Aktie falsch ...",
            "summary": "• ARK Invest verkauft Tesla-Anteile im Wert von 43,7 Millionen US-Dollar• Tesla-Aktie bleibt Top-Holding in drei ETFs• Cathie Wood sieht Tesla-Aktie falsch bewertet Die starke Entwicklung der Tesla-Aktie im Jahr 2020 war einer der Hauptwachstumstreiber in den ETFs der Investmentfirma ARK Invest. Im April hatte das Unternehmen bei einem Aktienpreis von rund 719 US-Dollar dann zuletzt einige Tesla-Aktien aus dem Depot geworfen, jetzt war es erneut soweit. Tesla-Aktien verkauft: 43,7 Millionen US-Dollar eingenommen ARK veräußerte 63.643 Tesla-Aktien und hat bei dem Verkauf 43,7 Millionen US-Dollar eingenommen, das geht aus dem Trading-Update des Unternehmens hervor. Tesla ist die Top-Holding im Flaggschiff ETF ARK Innovation und ist ebenfalls die größte Beteiligung in zwei weiteren ARK-ETFs: Dem Ark Autonomous Technology & Robotics ETF und dem Ark Next Generation Internet ETF. Insgesamt befinden sich nun noch 4.873.916 Tesla-Aktien in den ETFs von ARK Invest, der Gesamtwert des Investments belief sich zuletzt auf rund 3,3 Milliarden US-Dollar. Tesla von falschen Analysten falsch bewertet Dass der Teil-Verkauf von Tesla-Aktien den Langzeit-Bullen Wood an dem Elektroautobauer zweifeln lässt, ist allerdings nicht anzunehmen. Noch vor Veröffentlichung der Quartalsbilanz von Tesla hatte Wood in einem Interview ihr Basis-Kursziel von 3.000 US-Dollar für die Tesla-Aktie bestätigt. Gegenüber \"Real Vision\" nahm die Investorin dabei auch Tesla-Analysten ins Visier, die ihrer Meinung nach mit dafür verantwortlich sind, dass Tesla am Markt falsch bewertet wird: \"Wir glauben, dass der Grund für eine so große Ineffizienz bei Teslas Bewertung der kurzfristige Zeithorizont der Analysten ist und die Tatsache, dass die falschen Analysten folgen\". Sie betonte, dass Tesla mehrheitlich von Auto-Analysten bewertet werde, dabei sei der Konzern von Elon Musk ein \"facettenreiches Technologieunternehmen\". Bei ARK hab man eine andere Herangehensweise, um die Aktie von Tesla korrekt bewerten zu können: \"Tesla ist ein Technologieunternehmen, aber nicht nur ein Technologieunternehmen\", sagte sie und nannte in dem Zusammenhang auch Energiespeicher, Robotik, künstliche Intelligenz und Software-as-a-Service. \"Wir haben also drei Analysten, die das Tesla-Modell zusammenbauen\", erklärte sie. ARK investiert in Innovation Die Investmentgesellschaft der Starinvestorin hat sich vorrangig auf die Marktsegmente Digitalisierung und Technologie konzentriert und das Portfolio ihrer ETFs konsequent darauf ausgerichtet. Der Fokus hat dafür gesorgt, dass ARK in den vergangenen Jahren eine starke Rendite erwirtschaften konnte und im vergangenen Jahr auch Investorenlegende Warren Buffett und seiner Holding Berkshire Hathaway den Rang abgelaufen hatte.",
            "rights": "klamm.de",
            "rank": 7420,
            "topic": "news",
            "country": "unknown",
            "language": "de",
            "authors": [],
            "media": "https://static.klamm.de/news/news-img-k.jpg",
            "is_opinion": false,
            "twitter_account": null,
            "_score": 13.178295,
            "_id": "e3c5e3a88c985a015b6051812198670d"
        },
        {
            "title": "How much does a Tesla weigh? Comparing each model",
            "author": "Scooter Doll",
            "published_date": "2021-08-02 08:23:00",
            "published_date_precision": "full",
            "link": "https://electrek.co/2021/08/02/how-much-does-a-tesla-weigh-comparing-each-model",
            "clean_url": "electrek.co",
            "excerpt": "When learning more about Tesla and its growing fleet of EVs, consumers new to the market have a lot of the same questions. Inquiries such as How much does a Tesla cost? How long does it take to charge a Tesla? How much does it cost to charge a Tesla? Believe it or not, one of the most frequent questions we receive in addition to those above is, How much does a Tesla weigh? \nWhile this question is more easily answered than others, there are a few factors that play a role in the weight of each Tesla model. Here's everything you need to know broken down by model.\n more…\nThe post How much does a Tesla weigh? Comparing each model appeared first on Electrek.",
            "summary": "When learning more about Tesla and its growing fleet of EVs, consumers new to the market have a lot of the same questions. Inquiries such as How much does a Tesla cost? How long does it take to charge a Tesla? How much does it cost to charge a Tesla? Believe it or not, one of the most frequent questions we receive in addition to those above is, How much does a Tesla weigh?\n\nWhile this question is more easily answered than others, there are a few factors that play a role in the weight of each Tesla model. Here's everything you need to know broken down by model.\n\nHow much does each Tesla weigh?\n\nUnfortunately, your Tesla does not get an annual physical where a doctor can check in on your EV's weight, and there aren't too many vehicle-sized scales easily accessible to drivers.\n\nLuckily, Tesla has provided the weights of most of its vehicles, but they're still are varying factors.\n\nAside from different model types, some Teslas can vary in weight based on their trim or powertrain. Electric motors aren't as heavy ICE engine blocks, but they do carry some weight around.\n\nThat being said, more performance means more electric motors, and more motors mean additional weight.\n\nThe size and cargo space of the Tesla itself is also a pretty obvious factor, as a Model X will certainly weigh more than a Model 3 — and pretty much any other Tesla at this point.\n\nBelow is each Tesla's weight according to the American automaker, sorted by chronological debut.\n\nTesla's original Roadster EV\n\nTesla Roadster\n\nTesla's flagship EV remains its lightest model to date. The original Tesla Roadster sits as a limited-run EV and is now a collector's item for some, so its weight has not changed in the decade it's been around.\n\nThe first-generation Roadster weighs in at 2,723 lbs.\n\nModel S\n\nThe second oldest Tesla model on our list and the longest currently in production is the Model S sedan. After seeing a refresh earlier in 2021 that will eventually bring the tri-motor Plaid powertrain to drivers, the Model S can come with some weight.\n\nThe dual-motor Long Range trim, which has now been delayed to 2022, weighs 4,561 lbs.\n\nThe tri-motor Plaid Model S will weigh in at 4,766 lbs. when it (hopefully) delivers this fall.\n\nModel X\n\nThe largest current Tesla is unsurprisingly also the heaviest to date (we're still waiting on you, Cybertruck).\n\nCurrently available in two different trims, both the Long Range and new Plaid Model X weigh more than any of their Tesla siblings.\n\nThe Model X Long Range weighs 5,185 lbs., while the Plaid Model X and its three motors will weigh 5,390 lbs. Both trims are currently scheduled to arrive in the first quarter of 2022 alongside the Long Range Model S.\n\nModel 3\n\nThe cheapest Tesla available is also one of the very lightest, no matter the powertrain you choose. The Tesla Model 3 is currently available in three trims:\n\nThe single motor Model 3 Standard Range Plus is the second-lightest Tesla ever at 3,582 lbs.\n\nThe other two dual-motor Model 3 trims, Long Range and Performance, both weigh in at 4,065 lbs.\n\nModel Y\n\nThe newest Tesla to arrive currently sits in the middle of the pack on weight, which sits on brand with its pricing and performance as well.\n\nThe Tesla Model Y is currently available in either a Long Range or Performance dual-motor trim, and each weighs 4,416 lbs.\n\nWhat is the heaviest Tesla?\n\nIf you've skimmed through to this point, you must just be looking for weights and an answer to the question above without all the jibber-jabber. We respect that, so here you go.\n\nHere are all of Tesla's current models sorted heaviest to lightest:\n\n5,390 lbs – Model X Plaid\n\n5,185 lbs – Model X Long Range\n\n4,766 lbs – Model S Plaid\n\n4,561 lbs – Model S Long Range\n\n4,416 lbs – Model Y Long Range/Performance\n\n4,065 lbs – Model 3 Long Range/Performance\n\n3,582 lbs – Model 3 Standard Range Plus\n\n2,723 lbs Gen. 1 Tesla Roadster\n\nHow much does Tesla Cybertruck weigh?\n\nUnfortunately, we do not have that granular of specs on the upcoming Tesla Cybertruck yet, although we have asked Tesla several times.\n\nBased on the increased size and payload capacity (at least 3,500 lbs) compared to the current largest Tesla in the Model X, we anticipate the weight of the three upcoming powertrains on the Cybertruck to be between 5,000 and 6,500 lbs.\n\nThat being said, towing capacities up to 14,000 lbs., like Tesla is advertising for the tri-motor Cybertruck, could very well require more weight beyond 6,500 lbs.\n\nCheck back in with our Cybertruck guide periodically for the latest specs from Tesla.\n\nHow much does the 2nd generation Tesla Roadster weigh?\n\nMuch like the Cybertruck, Tesla has not yet revealed what the second-generation Roadster will tip the scales at when it debuts in 2022.\n\nBased on its size and touted performance, complete with new motors, we'd expect the new Roadster to land somewhere near the upcoming Model S trims, perhaps between 4,400 and 4,700 lbs.\n\nWe will know for certain when Tesla shares more details of the Gen. 2 Roadster… like whether it can actually hover or not.\n\nFTC: We use income earning auto affiliate links. More.\n\nSubscribe to Electrek on YouTube for exclusive videos and subscribe to the podcast.",
            "rights": "electrek.co",
            "rank": 3297,
            "topic": "news",
            "country": "US",
            "language": "en",
            "authors": [
                "Scooter Doll"
            ],
            "media": "https://i1.wp.com/electrek.co/wp-content/uploads/sites/3/2021/08/Tesla-on-a-scale.jpg?resize=1200%2C628&quality=82&strip=all&ssl=1",
            "is_opinion": false,
            "twitter_account": "@electrekco",
            "_score": 13.09692,
            "_id": "b9a2f7cabf9255d7e9ec19c6dc65018d"
        }
    ],
    "user_input": {
        "q": "Tesla",
        "search_in": [
            "title",
            "summary"
        ],
        "lang": null,
        "not_lang": null,
        "countries": null,
        "not_countries": null,
        "from": "2021-08-02 00:00:00",
        "to": null,
        "ranked_only": "True",
        "from_rank": null,
        "to_rank": null,
        "sort_by": "relevancy",
        "page": 1,
        "size": 2,
        "sources": null,
        "not_sources": null,
        "topic": null,
        "published_date_precision": null
    }
}

400 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 Invalid API Key

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

406 Unsupported Parameters

{
    "status": "error",
    "error_code": "UnsupportedParameter",
    "message": "Found unsupported parameter(s)['color']. Here are the parameters available for you plan => ['q', 'from', 'to', 'lang', 'not_lang', 'search_in', 'countries', 'not_countries', 'topic', 'sources', 'not_sources', 'sort_by', 'ranked_only', 'from_rank', 'to_rank', 'page', 'page_size', 'published_date_precision', 'author', 'author_null', 'outlet_name', 'enable_parse_date', 'enable_full_semantics']"
}

408 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 API calls

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

Get News

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

JSON format query input

Query Parameters

Name	Type	Description
q*	string	Keyword/keywords you're searching for. This is the most important part of your query. Please, refer to the Advanced Query Parameter section below for more examples and explanations.
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 language format section below for more details.
not_lang	array	Inverse to the lang parameter
published_date_precision	string	There are 3 types of date precision we define: full — day and time of an article is correctly identified with the appropriate timezone timezone unknown — day and time of an article is correctly identified without timezone date — only the day is identified without an exact time
search_in	string	By default, we search what you specified in the q parameter in both title and summary of the article. However, you can limit this to either title or summary
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
not_countries	array	The inverse of the countries parameter.
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.
sources	array	One or more news resources to filter your search. It should be the normal form of the URL, For example, nytimes.com,theguardian.com
not_sources	array	One or more sources to be excluded from the search. Comma-separated list. For example, cnn.com,wsj.com
ranked_only	boolean	Default: True Limit the search only for the sources which are in the top 1 million online websites. Unranked sources are assigned a rank that equals 999999
from_rank	integer	[0:999999] The lowest boundary of the rank of a news website to filter by. Important: lower rank means that a source is more popular
to_rank	integer	[0:999999] The upper boundary of the rank of a news website to filter by.
sort_by	string	relevancy (default value) — the most relevant results first date — the most recently published results first rank — the results from the highest-ranked sources first
page_size	integer	[1:100] How many articles to return per page.
page	integer	The number of the page. Use it to scroll through the results. This parameter is used to paginate: scroll through results because one API response cannot return more than 100 articles.
to	string	Until which point in time to search for. The default timezone is UTC. Availabe formats : YYYY/mm/dd YYYY/mm/dd HH:MM:SS English phrases like 1 day ago
from	string	From which point in time to start the search. The default timezone is UTC. Defaults to the past week. Availabe formats : YYYY/mm/dd YYYY/mm/dd HH:MM:SS English phrases like 1 day ago

Headers

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

200 Success

{
    "status": "ok",
    "total_hits": 10000,
    "page": 1,
    "total_pages": 5000,
    "page_size": 2,
    "articles": [
        {
            "title": "ARK reduziert Anteile: Cathie Wood wirft Tesla-Aktien aus dem Depot",
            "author": null,
            "published_date": "2021-08-04 01:15:00",
            "published_date_precision": "full",
            "link": "https://www.finanzen.net/nachricht/aktien/beteiligung-reduziert-ark-reduziert-anteile-cathie-wood-wirft-tesla-aktien-aus-dem-depot-10402608",
            "clean_url": "finanzen.net",
            "excerpt": "• ARK Invest verkauft Tesla-Anteile im Wert von 43,7 Millionen US-Dollar • Tesla-Aktie bleibt Top-Holding in drei ETFs • Cathie Wood sieht Tesla-Aktie falsch ...",
            "summary": "• ARK Invest verkauft Tesla-Anteile im Wert von 43,7 Millionen US-Dollar• Tesla-Aktie bleibt Top-Holding in drei ETFs• Cathie Wood sieht Tesla-Aktie falsch bewertet Die starke Entwicklung der Tesla-Aktie im Jahr 2020 war einer der Hauptwachstumstreiber in den ETFs der Investmentfirma ARK Invest. Im April hatte das Unternehmen bei einem Aktienpreis von rund 719 US-Dollar dann zuletzt einige Tesla-Aktien aus dem Depot geworfen, jetzt war es erneut soweit. Tesla-Aktien verkauft: 43,7 Millionen US-Dollar eingenommen ARK veräußerte 63.643 Tesla-Aktien und hat bei dem Verkauf 43,7 Millionen US-Dollar eingenommen, das geht aus dem Trading-Update des Unternehmens hervor. Tesla ist die Top-Holding im Flaggschiff ETF ARK Innovation und ist ebenfalls die größte Beteiligung in zwei weiteren ARK-ETFs: Dem Ark Autonomous Technology & Robotics ETF und dem Ark Next Generation Internet ETF. Insgesamt befinden sich nun noch 4.873.916 Tesla-Aktien in den ETFs von ARK Invest, der Gesamtwert des Investments belief sich zuletzt auf rund 3,3 Milliarden US-Dollar. Tesla von falschen Analysten falsch bewertet Dass der Teil-Verkauf von Tesla-Aktien den Langzeit-Bullen Wood an dem Elektroautobauer zweifeln lässt, ist allerdings nicht anzunehmen. Noch vor Veröffentlichung der Quartalsbilanz von Tesla hatte Wood in einem Interview ihr Basis-Kursziel von 3.000 US-Dollar für die Tesla-Aktie bestätigt. Gegenüber \"Real Vision\" nahm die Investorin dabei auch Tesla-Analysten ins Visier, die ihrer Meinung nach mit dafür verantwortlich sind, dass Tesla am Markt falsch bewertet wird: \"Wir glauben, dass der Grund für eine so große Ineffizienz bei Teslas Bewertung der kurzfristige Zeithorizont der Analysten ist und die Tatsache, dass die falschen Analysten folgen\". Sie betonte, dass Tesla mehrheitlich von Auto-Analysten bewertet werde, dabei sei der Konzern von Elon Musk ein \"facettenreiches Technologieunternehmen\". Bei ARK hab man eine andere Herangehensweise, um die Aktie von Tesla korrekt bewerten zu können: \"Tesla ist ein Technologieunternehmen, aber nicht nur ein Technologieunternehmen\", sagte sie und nannte in dem Zusammenhang auch Energiespeicher, Robotik, künstliche Intelligenz und Software-as-a-Service. \"Wir haben also drei Analysten, die das Tesla-Modell zusammenbauen\", erklärte sie. ARK investiert in Innovation Die Investmentgesellschaft der Starinvestorin hat sich vorrangig auf die Marktsegmente Digitalisierung und Technologie konzentriert und das Portfolio ihrer ETFs konsequent darauf ausgerichtet. Der Fokus hat dafür gesorgt, dass ARK in den vergangenen Jahren eine starke Rendite erwirtschaften konnte und im vergangenen Jahr auch Investorenlegende Warren Buffett und seiner Holding Berkshire Hathaway den Rang abgelaufen hatte.",
            "rights": "klamm.de",
            "rank": 7420,
            "topic": "news",
            "country": "unknown",
            "language": "de",
            "authors": [],
            "media": "https://static.klamm.de/news/news-img-k.jpg",
            "is_opinion": false,
            "twitter_account": null,
            "_score": 13.178295,
            "_id": "e3c5e3a88c985a015b6051812198670d"
        },
        {
            "title": "How much does a Tesla weigh? Comparing each model",
            "author": "Scooter Doll",
            "published_date": "2021-08-02 08:23:00",
            "published_date_precision": "full",
            "link": "https://electrek.co/2021/08/02/how-much-does-a-tesla-weigh-comparing-each-model",
            "clean_url": "electrek.co",
            "excerpt": "When learning more about Tesla and its growing fleet of EVs, consumers new to the market have a lot of the same questions. Inquiries such as How much does a Tesla cost? How long does it take to charge a Tesla? How much does it cost to charge a Tesla? Believe it or not, one of the most frequent questions we receive in addition to those above is, How much does a Tesla weigh? \nWhile this question is more easily answered than others, there are a few factors that play a role in the weight of each Tesla model. Here's everything you need to know broken down by model.\n more…\nThe post How much does a Tesla weigh? Comparing each model appeared first on Electrek.",
            "summary": "When learning more about Tesla and its growing fleet of EVs, consumers new to the market have a lot of the same questions. Inquiries such as How much does a Tesla cost? How long does it take to charge a Tesla? How much does it cost to charge a Tesla? Believe it or not, one of the most frequent questions we receive in addition to those above is, How much does a Tesla weigh?\n\nWhile this question is more easily answered than others, there are a few factors that play a role in the weight of each Tesla model. Here's everything you need to know broken down by model.\n\nHow much does each Tesla weigh?\n\nUnfortunately, your Tesla does not get an annual physical where a doctor can check in on your EV's weight, and there aren't too many vehicle-sized scales easily accessible to drivers.\n\nLuckily, Tesla has provided the weights of most of its vehicles, but they're still are varying factors.\n\nAside from different model types, some Teslas can vary in weight based on their trim or powertrain. Electric motors aren't as heavy ICE engine blocks, but they do carry some weight around.\n\nThat being said, more performance means more electric motors, and more motors mean additional weight.\n\nThe size and cargo space of the Tesla itself is also a pretty obvious factor, as a Model X will certainly weigh more than a Model 3 — and pretty much any other Tesla at this point.\n\nBelow is each Tesla's weight according to the American automaker, sorted by chronological debut.\n\nTesla's original Roadster EV\n\nTesla Roadster\n\nTesla's flagship EV remains its lightest model to date. The original Tesla Roadster sits as a limited-run EV and is now a collector's item for some, so its weight has not changed in the decade it's been around.\n\nThe first-generation Roadster weighs in at 2,723 lbs.\n\nModel S\n\nThe second oldest Tesla model on our list and the longest currently in production is the Model S sedan. After seeing a refresh earlier in 2021 that will eventually bring the tri-motor Plaid powertrain to drivers, the Model S can come with some weight.\n\nThe dual-motor Long Range trim, which has now been delayed to 2022, weighs 4,561 lbs.\n\nThe tri-motor Plaid Model S will weigh in at 4,766 lbs. when it (hopefully) delivers this fall.\n\nModel X\n\nThe largest current Tesla is unsurprisingly also the heaviest to date (we're still waiting on you, Cybertruck).\n\nCurrently available in two different trims, both the Long Range and new Plaid Model X weigh more than any of their Tesla siblings.\n\nThe Model X Long Range weighs 5,185 lbs., while the Plaid Model X and its three motors will weigh 5,390 lbs. Both trims are currently scheduled to arrive in the first quarter of 2022 alongside the Long Range Model S.\n\nModel 3\n\nThe cheapest Tesla available is also one of the very lightest, no matter the powertrain you choose. The Tesla Model 3 is currently available in three trims:\n\nThe single motor Model 3 Standard Range Plus is the second-lightest Tesla ever at 3,582 lbs.\n\nThe other two dual-motor Model 3 trims, Long Range and Performance, both weigh in at 4,065 lbs.\n\nModel Y\n\nThe newest Tesla to arrive currently sits in the middle of the pack on weight, which sits on brand with its pricing and performance as well.\n\nThe Tesla Model Y is currently available in either a Long Range or Performance dual-motor trim, and each weighs 4,416 lbs.\n\nWhat is the heaviest Tesla?\n\nIf you've skimmed through to this point, you must just be looking for weights and an answer to the question above without all the jibber-jabber. We respect that, so here you go.\n\nHere are all of Tesla's current models sorted heaviest to lightest:\n\n5,390 lbs – Model X Plaid\n\n5,185 lbs – Model X Long Range\n\n4,766 lbs – Model S Plaid\n\n4,561 lbs – Model S Long Range\n\n4,416 lbs – Model Y Long Range/Performance\n\n4,065 lbs – Model 3 Long Range/Performance\n\n3,582 lbs – Model 3 Standard Range Plus\n\n2,723 lbs Gen. 1 Tesla Roadster\n\nHow much does Tesla Cybertruck weigh?\n\nUnfortunately, we do not have that granular of specs on the upcoming Tesla Cybertruck yet, although we have asked Tesla several times.\n\nBased on the increased size and payload capacity (at least 3,500 lbs) compared to the current largest Tesla in the Model X, we anticipate the weight of the three upcoming powertrains on the Cybertruck to be between 5,000 and 6,500 lbs.\n\nThat being said, towing capacities up to 14,000 lbs., like Tesla is advertising for the tri-motor Cybertruck, could very well require more weight beyond 6,500 lbs.\n\nCheck back in with our Cybertruck guide periodically for the latest specs from Tesla.\n\nHow much does the 2nd generation Tesla Roadster weigh?\n\nMuch like the Cybertruck, Tesla has not yet revealed what the second-generation Roadster will tip the scales at when it debuts in 2022.\n\nBased on its size and touted performance, complete with new motors, we'd expect the new Roadster to land somewhere near the upcoming Model S trims, perhaps between 4,400 and 4,700 lbs.\n\nWe will know for certain when Tesla shares more details of the Gen. 2 Roadster… like whether it can actually hover or not.\n\nFTC: We use income earning auto affiliate links. More.\n\nSubscribe to Electrek on YouTube for exclusive videos and subscribe to the podcast.",
            "rights": "electrek.co",
            "rank": 3297,
            "topic": "news",
            "country": "US",
            "language": "en",
            "authors": [
                "Scooter Doll"
            ],
            "media": "https://i1.wp.com/electrek.co/wp-content/uploads/sites/3/2021/08/Tesla-on-a-scale.jpg?resize=1200%2C628&quality=82&strip=all&ssl=1",
            "is_opinion": false,
            "twitter_account": "@electrekco",
            "_score": 13.09692,
            "_id": "b9a2f7cabf9255d7e9ec19c6dc65018d"
        }
    ],
    "user_input": {
        "q": "Tesla",
        "search_in": [
            "title",
            "summary"
        ],
        "lang": null,
        "not_lang": null,
        "countries": null,
        "not_countries": null,
        "from": "2021-08-02 00:00:00",
        "to": null,
        "ranked_only": "True",
        "from_rank": null,
        "to_rank": null,
        "sort_by": "relevancy",
        "page": 1,
        "size": 2,
        "sources": null,
        "not_sources": null,
        "topic": null,
        "published_date_precision": null
    }
}

400 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 Invalid API Key

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

406 Unsupported Parameters

{
    "status": "error",
    "error_code": "UnsupportedParameter",
    "message": "Found unsupported parameter(s)['color']. Here are the parameters available for you plan => ['q', 'from', 'to', 'lang', 'not_lang', 'search_in', 'countries', 'not_countries', 'topic', 'sources', 'not_sources', 'sort_by', 'ranked_only', 'from_rank', 'to_rank', 'page', 'page_size', 'published_date_precision', 'author', 'author_null', 'outlet_name', 'enable_parse_date', 'enable_full_semantics']"
}

408 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 API calls

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

Successful Request Response

{
    "status": "ok",
    "total_hits": 7471,
    "page": 1,
    "total_pages": 7471,
    "page_size": 1,
    "articles": [
        {
            "title": "Is an Apple Music Subscription Worth It?",
            "author": "Shujaa Imran",
            "published_date": "2022-02-03 16:53:12",
            "published_date_precision": "full",
            "link": "https://www.makeuseof.com/apple-music-subscription-worth-it",
            "clean_url": "makeuseof.com",
            "excerpt": "Thinking of subscribing to Apple Music? Here's how to know if it's worth it for you.",
            "summary": "Since its launch in June 2015, Apple Music has been growing steadily. Because of its easy integration across Apple devices, many Apple users are fond of the streaming service. However, how does Apple Music stack up compared to the other streaming services out there? Does it justify a $9.99 subscription per month? We'll break down all the details for you, so you can decide whether an Apple Music subscription is truly worth it. What Is Apple Music?\nApple Music is the Apple's music streaming service, which allows subscribers to access millions of content for a subscription fee. With over 90 million songs, Apple Music content can either be streamed online or downloaded to your device for offline listening. \n\nConsidering Apple was late to the streaming market, its music streaming service has performed well. While Apple hasn't released any official figures, reports say that Apple Music had over 523 million subscribers by the end of 2021.\nAccording to Midia Research, Apple Music achieved a market share of 15% in 2021. In comparison, Spotify came at first place and captured 31% of the global streaming market in the same year. An Apple Music subscription combines subscription-based music streaming with global radio-like programming. With this, purchasing a subscription doesn't just unlock Apple Music's extensive 90-million song library for you to use. Apple Music also lets you watch music videos without ads, access a few podcasts, listen to its curated playlists, and tune into Apple Music's radio stations.\nApple's main radio offering, Apple Music 1, features an around-the-clock worldwide live broadcast from DJs based in Los Angeles, New York, and London. Other radio stations include Apple Music Hits, which play everyone's favorite songs from the '80s, '90s, and 2000s, and Apple Music Country, which features country music. Which Devices Does Apple Music Work on?\nApple Music is primarily available in the Music app on all iPhones, iPads, and iPod Touch models running iOS 8.4 or later. Aside from this, Apple Music is also available on PC (iTunes app), Mac (Music app), Apple TV, and Apple Watch. Apple Music is also available on non-Apple devices, such as Android phones, smart TVs, streaming boxes, and even game consoles. Alternatively, you can also access Apple Music online at music.apple.com.\nWhen using Apple Music, you can choose to either stream everything directly from the internet or download it onto your device for offline listening. If you're concerned about data usage, or you'll mostly be in an area without a good wireless connection, offline listening is a great feature. However, it could be an issue if you're already running low on storage space on your device.\nSimilar to other streaming services, you don't own the music files downloaded from Apple Music. With this, you won't be able to offload them anywhere else, burn them onto a disk, or use them in separate video projects. So, if you decide to cancel your Apple Music subscription, you'll lose access to your library. The Benefits of Apple Music\nApple Music works across different platforms including Android. However, its primary advantage is that it's integrated into Apple's ecosystem—meaning you can easily listen to your collection on your iPhone, iPad, Mac, and even Apple Watch.\nIn addition, Apple Music also features high-quality audio playback for audiophiles. For those who enjoy quality streaming, Apple Music offers Lossless, Hi-Res Lossless, Dolby Atmos, and Spatial Audio content, which arrived in June 2021.\nApart from your personal music library, Apple Music can help you enhance your collection with a mix of old and new tracks, along with Apple Music's three live radio stations. You can also stream TV shows, podcasts, music videos, and over 30,000 expertly curated playlists. The Drawbacks of Apple Music\nApple Music's main competitor, Spotify, also offers a robust streaming experience. A key drawback of Apple Music is that it doesn't offer a free version, whereas Spotify does, albeit with ads. Comparatively, Spotify also has a more extensive library than Apple Music, and offers better social media integration. Although, Apple Music still has better integration with the Apple ecosystem, and its content library is increasing every day.\nWhile Apple Music also includes podcasts, they're few and far in between. So, if you're looking for a way to listen to podcasts, Apple Podcasts has a much bigger and organized library. How Much Does Apple Music Cost?\nDepending on your needs, Apple Music operates as a subscription-based service and has different plans available. The basic monthly subscription is $10, which is the same as Spotify Premium and Tidal HiFi.\nAlternatively, you can pay an annual fee of $99. Other plans include a student subscription for $5 per month and a family plan that can be shared between six people for $15 per month. Apple also offers the Apple Music Voice Plan, which is available for $5 per month. The catch—you can only use Siri to verbally request songs, and the service is streaming only. With Apple Music Voice Plan, you can't use the app, download songs, use the Lyrics view, or access Apple's full Lossless audio and Dolby Atmos catalog. Does Apple Music Offer a Free Trial?\nUsually, Apple Music offers a 3-month trial for users looking to try out the subscription, after which it reverts to $9.99 per month. However, while there is no way to use Apple Music for free forever, there are a ton of ways to get it free for longer.\nWith free trials, you can choose to try out the service before you commit to a subscription. If you're not sold on Apple Music, you can simply cancel the trial before it expires. Gone are the times of playing music using CDs—digital music streaming is the new thing. While there are multiple streaming services to pick from, there's no doubt that Apple Music is worth considering.\nIf you own an Apple device, and you're actively looking to get a subscription for your music needs, we'd recommend giving Apple Music a try. In true Apple fashion, Apple Music makes things much easier for a variety of reasons. However, once you get tied into the ecosystem, it can become difficult to escape from. \n How to Get Started Using Apple Music Playlists In this article, we explore how to create, populate, share, discover, and become a master of Apple Music playlists. Related Topics Entertainment IPhone Media Streaming Apple Apple Music \n About The Author Shujaa Imran (54 Articles Published) More From Shujaa Imran Join our newsletter for tech tips, reviews, free ebooks, and exclusive deals!",
            "rights": "makeuseof.com",
            "rank": 1729,
            "topic": "news",
            "country": "CA",
            "language": "en",
            "authors": [
                "Shujaa Imran"
            ],
            "media": "https://static1.makeuseofimages.com/wordpress/wp-content/uploads/2022/02/thomas-kolnowski-uY-9Dyz8PPM-unsplash-2-1.jpg",
            "is_opinion": false,
            "twitter_account": "@MUO_official",
            "_score": 11.035287,
            "_id": "1017cfad154df78ba22b6b358d672e1f"
        }
    ],
    "user_input": {
        "q": "Apple",
        "search_in": [
            "title_summary"
        ],
        "lang": null,
        "not_lang": null,
        "countries": [
            "CA"
        ],
        "not_countries": null,
        "from": "2021-12-15 00:00:00",
        "to": null,
        "ranked_only": "True",
        "from_rank": null,
        "to_rank": null,
        "sort_by": "relevancy",
        "page": 1,
        "size": 1,
        "sources": null,
        "not_sources": null,
        "topic": null,
        "published_date_precision": null
    }
}

Return Body Fields

Object	Sub Object	Description
status		Returns ok if everything went well. Returns error in case of an error (plus 2 additional fields in case of error — error_code and message)
total_hits		How many news articles match your search criterion. Maximum is 10,000
page		The page where you are at
total_pages		How many pages you can access given your page_size parameter
page_size		How many news articles are in the returned JSON object
articles:		News articles found. list
	title	The title of the article
	author	The author of the article
	published_date	Published date & time
	published_date_precision	Accuracy of the published_date field. There are 3 types of date precision we define: full — day and time of an article is correctly identified with the appropriate timezone timezone unknown — day and time of an article is correctly identified without timezone date — only the day is identified without an exact time
	link	Full URL where the article was originally published
	clean_url	The URL of the article's source
	excerpt	Short summary of the article provided by the publisher
	summary	The full content of the article
	rights	Copyright
	rank	The page rank of the source website (which is given in the clean_url)
	topic	The main topic of the news publisher. Important: This parameter is not deducted on a per-article level: it is deducted on the per-publisher level
	country	The country of the publisher
	language	The language of the article
	authors	A string of comma separated author names (can be an array for some articles before May 2022)
	media	A link to a thumbnail image of the article
	is_opinion	True if the article is an "Opinion" article
	twitter_account	The Twitter account of the publisher
	_score	How well the article is matching your search criteria. _score is different for each search you make. The best matching article has the highest score
	_id	Newscatcher API's unique identifier for each news article
user_input		An object that returns how our backend saw your request. It shows you which parameters have been used to perform a search. Useful for debugging, especially to check if there is any problem with URL encoding

Advanced Query [q] Parameter

In case you're not the type of developer who will read through the entire section, here're 3 most important rules that you have to follow:

1. Be aware that, by default, tokens (keywords you're searching for) passed into the q parameter are split with AND operator. This means each token has to be present in the text at least once. For example, q=Apple Microsoft will be read as q=Apple AND Microsoft

2. Always use double quotes (") when you search for companies, person names, etc. For example, if you want to find articles where Tim Cook is mentioned, you should pass q="Tim Cook" (not q=Tim Cook)

3. Make sure that what you pass into the q parameter is URL-encoded.

4. While making your first calls, check the user_input list in the JSON that we return to you. Make sure our API saw your keywords as you intended.

Exact Match ("double quotes")

Use double quotes (") for the exact match.

When you want to search for articles that mention Tim Cook you should do the following query:

q="Tim Cook"

If you write q=Tim Cook then it will be treated as q=Tim AND Cook. In that case, every article that mentions tim and cook will match.

Moreover, if you specify lang=en that will also match the articles with cooking, cooked, and other stems of the word cook

Boolean: AND

AND operator makes tokens from both sides to be present in the text. AND is the default operator. When your q input is more than 1 word, AND operator is added between each word behind the scenes. Therefore, q=Apple Microsoft Tesla is the same as q=Apple AND Microsoft AND Tesla For example, if we want both Microsoft and Tesla to be present in the returned news articles, the q parameter should look as follows:

q=Microsoft AND Tesla

or

q=Microsoft && Tesla

Boolean: OR

OR can also be written as ||

OR operator means that either the left or the right sides of OR have to be satisfied.

You should use Grouping when you want to logically group a set of tokens. For example:

q=(Apple AND Cook) OR (Microsoft AND Gates)

or

q=(Apple && Cook) || (Microsoft && Gates)

Boolean: NOT

NOT can also be written as !

Use NOT operator when you want the token from its right not to be present. For example, if we want to search for articles about Microsoft and not about Tesla, the q parameter should look as follows:

q=Microsoft NOT Tesla

or

q=Microsoft !Tesla

MUST (MUST NOT)

Prepend a token with a + (plus sign) if it MUST appear in the searched text

Make sure that your API call is URL encoded. Check the user_input object in the Response Body to see how our back end saw your request.

+ will be escaped by default in many situations.

Make sure that your API call is URL encoded. Check the user_input object in the Response Body to see how our back end saw your request.

+ (plus sign) will be escaped by default in many situations. Therefore, we recommend using its URL-encoded version: %2B

Prepend a token with a - (minus sign) if it MUST NOT appear in the searched text

For example, if we want to search for news articles that contain Elon Musk but not Grimes, we have to write:

q=Elon Musk -Grimes

"But wait, the query above will also match the documents where only Elon or Musk are present" Shouldn't we write +Elon +Musk -Grimes ?

If we write +Elon +Musk -Grimes that means that Elon and Musk should be present in the text, however, not in that particular. The "correct" query should look like this:

q="Elon Musk" -Grimes

In this case, we will search for an exact match of "Elon Musk" , plus, Grimes must not be present.

In general, you should always put person and company names in quotes.

Wildcards (* and ?)

Use * to match any string in any quantity

Use ? to match any string exactly once

For example, we want to search for articles that mention Microsort and any C-level officers:

q=Microsoft +C?O

language format

You should use ISO 639-1 — 2 letter code.

For example, English - en

Important: We distinguish Chinese (China) and Chinese (Taiwan) languages, cn and tw accordingly. That is the only difference between us and ISO 639-1 code.

The list of languages we support:

af,ar,bg,bn,ca,cs,cy,cn,da,de,el,en,es,et,fa,fi,fr,gu,he,hi,hr,hu,id,it,ja,kn,ko,lt,lv,mk,ml,mr,ne,nl,no,pa,pl,pt,ro,ru,sk,sl,so,sq,sv,sw,ta,te,th,tl,tr,tw,uk,ur,vi

countries format

You should use ISO 3166-1 alpha-2 code.

For example, France - FR

You can find the entire list via the following link: https://www.iso.org/obp/ui/#search

Debugging

While developing, look at user_input object that returns all of your parameters. If you made a mistake, or some characters were not correctly parsed because of the URL encoding, you will see that.