v3 Authors

Get the articles published by an author

Get Articles Published By Author

GET https://v3-api.newscatcherapi.com/api/authors?author_name=Fiona Jackson&by_parse_date=false&sort_by=relevancy&page=1&page_size=100

Query Parameters

Name	Type	Description
author_name*	string	The author you're searching for. This parameter returns exact matches only.
not_author_name	string	Inverse to the author_name parameter
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 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
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.
sources	array	One or more news sources to narrow down your search. The format should be a domain url from your URL. Subdomains, like finance.yahoo.com are also accepted. Comma-separated string or a list/array. For example, nytimes.com,theguardian.com,finance.yahoo.com
not_sources	array	One or more sources to be excluded from the search. Comma-separated string or a list/array. 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:1000] 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 1000 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
by_parse_date	boolean	When set to True, transforms your from_ and to_ parameters to filter by parse_date instead of published_date Be aware that a new variable parse_date will be added to the output list with each article.
is_headline	boolean	When set to True, only articles that were posted on the home page of a given news domain will be shown.
is_opinion	boolean	[Still in development phase] When set to True, only articles that are determined to be an opinion piece will be returned. Set False to exclude opinion-based articles and receive news only.
parent_url	array	One or more categorical URL to filter your search. It should be the normal form of the URL, For example, https://www.washingtonpost.com/politics,https://www.washingtonpost.com/technology,https://www.washingtonpost.com/business
all_links	array	Search for desired URL mentioned in the article. Please, refer to the All Links And Domains Format pagefor more examples and explanations.
all_domain_links	array	Search for desired domain URL mentioned in the article. Please, refer to the All Links And Domains Format page for more examples and explanations.
word_count_min	integer	Set a minimum number of words that an article must contain. To be used for avoiding avoid articles with small content.
word_count_max	integer	Set a maximum number of words that an article must contain. To be used for avoiding avoid articles with big content.
include_nlp_data	boolean	When set to True, adds to each article a NLP layer. Not available for all plans. Please contact us to enable it.
theme	string	[Available only if NLP is enabled for your API key] A general topic of an article. Topic labelling is based on the actual content of an article. Accepted values: Business, Economics, Entertainment, Finance, Health, Politics, Science, Sports, Tech, Crime, Lifestyle, Automotive , Travel, Weather, General Comma-separated string or a list/array. Multiple themes can be selected. For example: Business Business, Finance
ORG_entity_name	string	[Available only if NLP is enabled for your API key] ORG stands for Organisation. We identify company names mentioned in articles and enable you to search for them. More information on Search By Entity
has_nlp	boolean	[Available only if NLP is enabled for your API key] When set to True, filter data only to those articles that have an NLP layer.
title_sentiment_min	float	[Available only if NLP is enabled for your API key] Narrow down your search to only positive or negative news based on the article's title sentiment. The value can vary from -1 to 1.
title_sentiment_max	float	[Available only if NLP is enabled for your API key] Narrow down your search to only positive or negative news based on the article's title sentiment. The value can vary from -1 to 1.
content_sentiment_min	float	[Available only if NLP is enabled for your API key] Narrow down your search to only positive or negative news based on the article's content sentiment. The value can vary from -1 to 1.
content_sentiment_max	float	[Available only if NLP is enabled for your API key] Narrow your search to only positive or negative news based on the article's content sentiment. The value can vary from -1 to 1.
is_paid_content	boolean	[Still in development phase] When set to False, only articles that publish full public available content will be shown. Some news publishers partially block content of their articles, so we get only several sentences from them. This filter will help you get full content.
clustering_enabled	boolean	[Available only if NLP is enabled for your API key] When set to True, enables clustering on articles. Instead of showing a list of articles, you will be given a list of clustering to put together similar articles. Please refer to the Clustering News Articles page for more examples and explanations.
clustering_threshold	float	[Available only if NLP is enabled for your API key] Set a threshold for an article to be similar. Default value: 0.6 The value can vary from 0 to 1.
clustering_variable	string	[Available only if NLP is enabled for your API key] Select the data on which you want the similarity to be calculated on. Accepted values: content, title, summary Default value: content
PER_entity_name	string	[Available only if NLP is enabled for your API key] PER stands for Person. We identify people's names mentioned in articles and enable you to search for them. More information on Search By Entity
LOC_entity_name	string	[Available only if NLP is enabled for your API key] LOC stands for Location. We identify geographical locations mentioned in articles and enable you to search for them. More information on Search By Entity
MISC_entity_name	string	[Available only if NLP is enabled for your API key] MISC stands for Miscellaneous. We identify products and other names mentioned in articles and enable you to search for them. More information on Search By Entity
predefined_sources	string	Use our TOP predifined sources per country. Later we are going to improve it and add more functionality, like top categories etc. The format should be strictly like this: - starting with word top - put the number of desired sources top source - 2 letter country code ISO 3166-1 alpha-2 For example: top 100 US top 33 AT top 5 GB It is also possible to put multiple countries with custom number of top sources, should be comma separated. For example: top 100 US, GB top 33 AT, 55 IT
iptc_tags	string	[Available only if tags are enabled for your API key] We label articles with IPTC tags based on the content and enable you to filter articles based on the tags. Only IPTC tag IDs can be used in this parameter. For example, 20000183,20000199,20000188 or just 20000188
not_iptc_tags	string	[Available only if tags are enabled for your API key] Inverse of the iptc_tags parameter; it enables you to filter articles based on their IPTC tags.
not_author_name	array	List of author names that you want to exclude from your search. Usually, you might want to exclude articles where one of the authors is Associated Press, or PRNewswire. For example: PRNewswire, AOL Staff
not_theme	string	[Available only if NLP is enabled for your API key] Inverse of the theme parameter; it enables you to filter articles based on their general topic.
source_name	array	NewsCatcher team does not suggest using source_name in Production. The best parameter to get data from a specific News Domain is sources. One or more news source names to narrow down your search. Comma-separated string or a list/array. For example: CryptoPotato,thethings

Headers

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

200 Success

{
  "status": "ok",
  "total_hits": 3,
  "page": 1,
  "total_pages": 1,
  "page_size": 100,
  "articles": [
    {
      "title": "Quantum Cloud Computing Secured in New Breakthrough at Oxford",
      "author": "Fiona Jackson",
      "authors": [
        "Editor Bath",
        "Uk. At Techrepublic",
        "Fiona Jackson",
        "Content Writer",
        "Emea Region."
      ],
      "journalists": [
        "Fiona Jackson"
      ],
      "published_date": "2024-04-19 18:19:54",
      "published_date_precision": "full",
      "updated_date": "2024-04-19 18:19:54",
      "updated_date_precision": "full",
      "link": "https://www.techrepublic.com/article/quantum-cloud-computing-security-privacy",
      "domain_url": "techrepublic.com",
      "full_domain_url": "techrepublic.com",
      "name_source": "TechRepublic",
      "is_headline": false,
      "paid_content": false,
      "parent_url": "https://www.techrepublic.com/topic",
      "country": "US",
      "rights": "techrepublic.com",
      "rank": 941,
      "media": "https://assets.techrepublic.com/uploads/2024/04/AdobeStock_705517006.jpg",
      "language": "en",
      "description": "Businesses are one step closer to quantum computing thanks to a breakthrough made in its security by scientists at Oxford University.",
      "content": "Businesses are one step closer to quantum cloud computing, thanks to a breakthrough made in its security and privacy by scientists at Oxford University.\nThe researchers used an approach dubbed ‘blind quantum computing' to connect two quantum computing entities (Figure A); this simulates the situation where an employee at home or in an office remotely connects to a quantum server via the cloud. With this method, the quantum server provider does not need to know any details of the computation for it to be carried out, keeping the user's proprietary work secure. The user can also easily verify the authenticity of their result, confirming it is neither erroneous nor corrupted.\nFigure A\nFigure A The researchers used an approach dubbed 'blind quantum computing' to connect two quantum computing entities in a way that is completely secure. Image: David Nadlinger/Oxford University Ensuring the security and privacy of quantum computations is one of the most significant roadblocks that has held the powerful technology back so far, so this work could lead to it finally entering the mainstream.\nDespite only being tested on a small scale, the researchers say their experiment has the potential to be scaled up to large quantum computations. Plug-in devices could be developed that safeguard a worker's data while they access quantum cloud computing services.\nProfessor David Lucas, the co-head of the Oxford University Physics research team, said in a press release: 'We have shown for the first time that quantum computing in the cloud can be accessed in a scalable, practical way which will also give people complete security and privacy of data, plus the ability to verify its authenticity.'\nWhat is quantum cloud computing? Classical computers process information as binary bits represented as 1s and 0s, but quantum computers do so using quantum bits, or qubits. Qubits exist as both a 1 and a 0 at the same time, but with a probability of being one or the other that is determined by their quantum state. This property enables quantum computers to tackle certain calculations much faster than classical computers, as they can solve problems simultaneously.\nQuantum cloud computing is where quantum resources are provided to users remotely over the internet; this allows anyone to utilise quantum computing without the need for specialised hardware or expertise.\nFREE DOWNLOAD: Quantum computing: An insider's guide\nFREE DOWNLOAD: Quantum computing: An insider's guide Why is ‘blind quantum computing' more secure? With typical quantum cloud computing, the user must divulge the problem they are trying to solve to the cloud provider; this is because the provider's infrastructure needs to understand the specifics of the problem so it can allocate the appropriate resources and execution parameters. Naturally, in the case of proprietary work, this presents a security concern.\nThis security risk is minimised with the blind quantum computing method because the user remotely controls the quantum processor of the server themselves during a computation. The information required to keep the data secure — like the input, output and algorithmic details — only needs to be known by the client because the server does not make any decisions with it.\nHow blind quantum cloud computing works. 'Never in history have the issues surrounding privacy of data and code been more urgently debated than in the present era of cloud computing and artificial intelligence,' said Professor Lucas in the press release.\n'As quantum computers become more capable, people will seek to use them with complete security and privacy over networks, and our new results mark a step change in capability in this respect.'\nHow could quantum computing impact business? Quantum computing is vastly more powerful than conventional computing, and could revolutionise how we work if it is successfully scaled out of the research phase. Examples include solving supply chain problems, optimising routes and securing communications.\nIn February, the U.K. government announced a £45 million ($57 million) investment into quantum computing; the money goes toward finding practical uses for quantum computing and creating a 'quantum-enabled economy' by 2033. In March, quantum computing was singled out in the Ministerial Declaration, with G7 countries agreeing to work together to promote the development of quantum technologies and foster collaboration between academia and industry. Just this month, the U.K.'s second commercial quantum computer came online.\nDue to the extensive power and refrigeration requirements, very few quantum computers are currently commercially available. However, several leading cloud providers do offer so-called quantum-as-a-service to corporate clients and researchers. Google's Cirq, for example, is an open source quantum computing platform, while Amazon Braket allows users to test their algorithms on a local quantum simulator. IBM, Microsoft and Alibaba also have quantum-as-a-service offerings.\nWATCH: What classic software developers need to know about quantum computing\nWATCH: What classic software developers need to know about quantum computing But before quantum computing can be scaled up and used for business applications, it is imperative to ensure it can be achieved while safeguarding the privacy and security of customer data. This is what the Oxford University researchers hoped to achieve in their new study, published in Physical Review Letters.\nDr. Peter Dmota, study lead, told TechRepublic in an email: 'Strong security guarantees will lower the barrier to using powerful quantum cloud computing services, once available, to speed up the development of new technologies, such as batteries and drugs, and for applications that involve highly confidential data, such as private medical information, intellectual property, and defence. Those applications exist also without added security, but would be less likely to be used as widely.\n'Quantum computing has the potential to drastically improve machine learning. This would supercharge the development of better and more adapted artificial intelligence, which we are already seeing impacting businesses across all sectors.\n'It is conceivable that quantum computing will have an impact on our lives in the next five to ten years, but it is difficult to forecast the exact nature of the innovations to come. I expect a continuous adaptation process as users start to learn how to use this new tool and how to apply it to their jobs — similar to how AI is slowly becoming more relevant at the mainstream workplace right now.\n'Our research is currently driven by quite general assumptions, but as businesses start to explore the potential of quantum computing for them, more specific requirements will emerge and drive research into new directions.'\nHow does blind quantum cloud computing work? Blind quantum cloud computing requires connecting a client computer that can detect photons, or particles of light, to a quantum computing server with a fibre optic cable ( Figure B ). The server generates single photons, which are sent through the fibre network and received by the client.\nFigure B). The server generates single photons, which are sent through the fibre network and received by the client. Figure B\nFigure B The researchers connected a client computer that could detect photons, or particles of light, to a quantum computing server with a fibre optic cable. Image: David Nadlinger/Oxford University The client then measures the polarisation, or orientation, of the photons, which tells it how to remotely manipulate the server in a way that will produce the desired computation. This can be done without the server needing access to any information about the computation, making it secure.\nTo provide additional assurance that the results of the computation are not erroneous or have been tampered with, additional tests can be undertaken. While tampering would not harm the security of the data in a blind quantum computation, it could still corrupt the result and leave the client unaware.\n'The laws of quantum mechanics don't allow copying of information and any attempt to observe the state of the memory by the server or an eavesdropper would corrupt the computation,' Dr Dmota explained to TechRepublic in an email. 'In that case, the user would notice that the server isn't operating faithfully, using a feature called ‘verification', and abort using their service if there are any doubts.\n'Since the server is ‘blind' to the computation — ie, is not able to distinguish different computations — the client can evaluate the reliability of the server by running simple tests whose results can be easily checked.\n'These tests can be interleaved with the actual computation until there is enough evidence that the server is operating correctly and the results of the actual computation can be trusted to be correct. This way, honest errors as well as malicious attempts to tamper with the computation can be detected by the client.'\nFigure C\nFigure C Dr Peter Drmota (pictured) said that the research is 'a big step forward in both quantum computing and keeping our information safe online.' Image: Martin Small/Oxford University What did the researchers discover through their blind quantum cloud computing experiment? The researchers found the computations their method produced 'could be verified robustly and reliably', as per the paper. This means that the client can trust the results have not been tampered with. It is also scalable, as the number of quantum elements being manipulated for performing calculations can be increased 'without increasing the number of physical qubits in the server and without modifications to the client hardware,' the scientists wrote.\nDr. Drmota said in the press release, 'Using blind quantum computing, clients can access remote quantum computers to process confidential data with secret algorithms and even verify the results are correct, without revealing any useful information. Realising this concept is a big step forward in both quantum computing and keeping our information safe online.'\nThe research was funded by the UK Quantum Computing and Simulation Hub — a collaboration of 17 universities supported by commercial and government organisations. It is one of four quantum technology hubs in the UK National Quantum Technologies Programme.",
      "word_count": 1618,
      "is_opinion": false,
      "twitter_account": "@TechRepublic",
      "all_links": [
        "https://journals.aps.org/prl/abstract/10.1103/PhysRevLett.132.150604",
        "https://solutions.technologyadvice.com/meet-the-editorial-team/",
        "https://flipboard.com/@techrepublic/cybersecurity-and-cyberwar-r36o4ug0z",
        "https://ibm-research.medium.com/exxonmobil-ibm-scientists-explore-state-of-art-quantum-algorithms-to-solve-routing-formulations-e7ce39f8741c",
        "https://technologyadvice.com/privacy-policy/ccpa-opt-out-form/",
        "https://twitter.com/techrepublic",
        "https://www.youtube.com/techrepublic",
        "https://techrepublic.atlassian.net/servicedesk/customer/portal/2",
        "https://technologyadvice.com/terms-conditions/",
        "https://solutions.technologyadvice.com/advertise-on-techrepublic/?utm_source=techrepublic&utm_medium=portfolio_footer&utm_campaign=advertise_contact-us",
        "https://technologyadvice.com/careers/",
        "https://www.oxinst.com/news/rigetti-and-oxford-instruments-announce-successful-completion-of-innovate-uk-project-to-launch-one-of-the-first-uk-based-quantum-computers/",
        "https://www.physics.ox.ac.uk/about-us/media/latest-media-release",
        "https://technologyadvice.com/privacy-policy/",
        "https://www.nature.com/articles/s41586-020-03093-8",
        "https://www.facebook.com/TechRepublic",
        "https://www.honeywell.com/us/en/news/2021/01/exploring-supply-chain-solutions-with-quantum-computing"
      ],
      "all_domain_links": [
        "facebook.com",
        "technologyadvice.com",
        "twitter.com",
        "aps.org",
        "honeywell.com",
        "flipboard.com",
        "medium.com",
        "youtube.com",
        "oxinst.com",
        "nature.com",
        "atlassian.net",
        "ox.ac.uk"
      ],
      "id": "d92a6e149229c74baf1ae6f53a6d3414",
      "score": 9.935215
    }...
  ],
  "user_input": {
    "author_name": "\"Fiona Jackson\"",
    "not_author_name": null,
    "sources": null,
    "predefined_sources": null,
    "not_sources": null,
    "lang": null,
    "not_lang": null,
    "countries": null,
    "not_countries": null,
    "from_": "2024-04-17T00:00:00",
    "to_": "2024-04-24T08:56:41.304698",
    "published_date_precision": null,
    "by_parse_date": false,
    "sort_by": "relevancy",
    "ranked_only": null,
    "from_rank": null,
    "to_rank": null,
    "is_headline": null,
    "is_paid_content": null,
    "parent_url": null,
    "all_links": null,
    "all_domain_links": null,
    "word_count_min": null,
    "word_count_max": null,
    "page": 1,
    "page_size": 100,
    "include_nlp_data": null,
    "has_nlp": null,
    "theme": null,
    "not_theme": null,
    "ner_name": null,
    "title_sentiment_min": null,
    "title_sentiment_max": null,
    "content_sentiment_min": null,
    "content_sentiment_max": null,
    "iptc_tags": null,
    "not_iptc_tags": null,
    "iab_tags": null,
    "not_iab_tags": null
  }
}

406 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

{
    "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"
}

403: Forbidden Invalid API Key

{
    "message": "Forbidden",s
    "code": 403
}

422: Unprocessable Entity Parameter is not allowed

{
    "message": "Param langs is not allowed for plan nlp"
}

Get Articles Published By Author

POST https://v3-api.newscatcherapi.com/api/authors?

Headers

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

Request Body

Name	Type	Description
author_name*	string	The author you're searching for. This parameter returns exact matches only.
not_author_name	string	Inverse to the author_name parameter
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 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
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.
sources	array	One or more news sources to narrow down your search. The format should be a domain url from your URL. Subdomains, like finance.yahoo.com are also accepted. Comma-separated string or a list/array. For example, nytimes.com,theguardian.com,finance.yahoo.com
not_sources	array	One or more sources to be excluded from the search. Comma-separated string or a list/array. 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:1000] 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 1000 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
by_parse_date	boolean	When set to True, transforms your from_ and to_ parameters to filter by parse_date instead of published_date Be aware that a new variable parse_date will be added to the output list with each article.
is_headline	boolean	When set to True, only articles that were posted on the home page of a given news domain will be shown.
is_opinion	boolean	[Still in development phase] When set to True, only articles that are determined to be an opinion piece will be returned. Set False to exclude opinion-based articles and receive news only.
parent_url	array	One or more categorical URL to filter your search. It should be the normal form of the URL, For example, https://www.washingtonpost.com/politics,https://www.washingtonpost.com/technology,https://www.washingtonpost.com/business
all_links	array	Search for desired URL mentioned in the article. Please, refer to the All Links And Domains Format section for more examples and explanations.
all_domain_links	array	Search for desired domain URL mentioned in the article. Please, refer to the All Links And Domains Format section for more examples and explanations.
word_count_min	integer	Set a minimum number of words that an article must contain. To be used for avoiding avoid articles with small content.
word_count_max	integer	Set a maximum number of words that an article must contain. To be used for avoiding avoid articles with big content.
include_nlp_data	boolean	When set to True, adds to each article a NLP layer. Not available for all plans. Please contact us to enable it.
theme	string	[Available only if NLP is enabled for your API key] A general topic of an article. Topic labelling is based on the actual content of an article. Accepted values: Business, Economics, Entertainment, Finance, Health, Politics, Science, Sports, Tech, Crime, Lifestyle, Automotive , Travel, Weather, General Comma-separated string or a list/array. Multiple themes can be selected. For example: Business Business, Finance
ORG_entity_name	string	[Available only if NLP is enabled for your API key] ORG stands for Organisation. We identify company names mentioned in articles and enable you to search for them. More information on Search By Entity
has_nlp	boolean	[Available only if NLP is enabled for your API key] When set to True, filter data only to those articles that have an NLP layer.
title_sentiment_min	float	[Available only if NLP enabled for your plan] Narrow down your search to only possitive or negative news based on article's title sentiment. The value can vary from -1 to 1.
title_sentiment_max	float	[Available only if NLP is enabled for your API key] Narrow down your search to only positive or negative news based on the article's title sentiment. The value can vary from -1 to 1.
content_sentiment_min	float	[Available only if NLP is enabled for your API key] Narrow down your search to only positive or negative news based on the article's content sentiment. The value can vary from -1 to 1.
content_sentiment_max	float	[Available only if NLP is enabled for your API key] Narrow down your search to only positive or negative news based on the article's content sentiment. The value can vary from -1 to 1.
is_paid_content	String	[Still in development phase] When set to False, only articles that publish full public available content will be shown. Some news publishers partially block content of their articles, so we get only several sentences from them. This filter will help you get full content.
clustering_enabled	boolean	[Available only if NLP is enabled for your API key] When set to True, it enables clustering on articles. Instead of showing a list of articles, you will be given a list of clustering to put together similar articles. Please refer to the Deduplicate Data With Clustering section for more examples and explanations.
clustering_threshold	float	[Available only if NLP is enabled for your API key] Set a threshold for an article to be similar. Default value: 0.6 The value can vary from 0 to 1.
clustering_variable	string	[Available only if NLP is enabled for your API key] Select the data on which you want the similarity to be calculated. Accepted values: content, title, summary Default value: content
PER_entity_name	string	[Available only if NLP is enabled for your API key] PER stands for Person. We identify people's names mentioned in articles and enable you to search for them. More information on Search By Entity
LOC_entity_name	string	[Available only if NLP is enabled for your API key] LOC stands for Location. We identify geographical locations mentioned in articles and enable you to search for them. More information on Search By Entity
MISC_entity_name	string	[Available only if NLP is enabled for your API key] MISC stands for Miscellaneous. We identify products and other names mentioned in articles and enable you to search for them. More information on Search By Entity
predefined_sources	string	Use our TOP predifined sources per country. Later we are going to improve it and add more functionality, like top categories etc. The format should be strictly like this: - starting with word top - put the number of desired sources top source - 2 letter country code ISO 3166-1 alpha-2 For example: top 100 US top 33 AT top 5 GB It is also possible to put multiple countries with custom number of top sources, should be comma separated. For example: top 100 US, GB top 33 AT, 55 IT
not_iptc_tags	string	[Available only if tags are enabled for your API key] Inverse of the iptc_tags parameter; it enables you to filter articles based on their IPTC tags.
iptc_tags	string	[Available only if tags are enabled for your API key] We label articles with IPTC tags based on the content and enable you to filter articles based on the tags. Only IPTC tag IDs can be used in this parameter. For example, 20000183,20000199,20000188 or just 20000188
not_author_name	array	List of author names that you want to exclude from your search. Usually, you might want to exclude articles where one of the authors is Associated Press, or PRNewswire. For example: PRNewswire, AOL Staff
not_theme	string	[Available only if NLP is enabled for your API key] Inverse of the theme parameter; it enables you to filter articles based on their general topic.
source_name	array	NewsCatcher team does not suggest using source_name in Production. The best parameter to get data from a specific News Domain is sources. One or more news source names to narrow down your search. Comma-separated string or a list/array. For example: CryptoPotato,thethings

200 Success

{
  "status": "ok",
  "total_hits": 3,
  "page": 1,
  "total_pages": 1,
  "page_size": 100,
  "articles": [
    {
      "title": "Quantum Cloud Computing Secured in New Breakthrough at Oxford",
      "author": "Fiona Jackson",
      "authors": [
        "Editor Bath",
        "Uk. At Techrepublic",
        "Fiona Jackson",
        "Content Writer",
        "Emea Region."
      ],
      "journalists": [
        "Fiona Jackson"
      ],
      "published_date": "2024-04-19 18:19:54",
      "published_date_precision": "full",
      "updated_date": "2024-04-19 18:19:54",
      "updated_date_precision": "full",
      "link": "https://www.techrepublic.com/article/quantum-cloud-computing-security-privacy",
      "domain_url": "techrepublic.com",
      "full_domain_url": "techrepublic.com",
      "name_source": "TechRepublic",
      "is_headline": false,
      "paid_content": false,
      "parent_url": "https://www.techrepublic.com/topic",
      "country": "US",
      "rights": "techrepublic.com",
      "rank": 941,
      "media": "https://assets.techrepublic.com/uploads/2024/04/AdobeStock_705517006.jpg",
      "language": "en",
      "description": "Businesses are one step closer to quantum computing thanks to a breakthrough made in its security by scientists at Oxford University.",
      "content": "Businesses are one step closer to quantum cloud computing, thanks to a breakthrough made in its security and privacy by scientists at Oxford University.\nThe researchers used an approach dubbed ‘blind quantum computing' to connect two quantum computing entities (Figure A); this simulates the situation where an employee at home or in an office remotely connects to a quantum server via the cloud. With this method, the quantum server provider does not need to know any details of the computation for it to be carried out, keeping the user's proprietary work secure. The user can also easily verify the authenticity of their result, confirming it is neither erroneous nor corrupted.\nFigure A\nFigure A The researchers used an approach dubbed 'blind quantum computing' to connect two quantum computing entities in a way that is completely secure. Image: David Nadlinger/Oxford University Ensuring the security and privacy of quantum computations is one of the most significant roadblocks that has held the powerful technology back so far, so this work could lead to it finally entering the mainstream.\nDespite only being tested on a small scale, the researchers say their experiment has the potential to be scaled up to large quantum computations. Plug-in devices could be developed that safeguard a worker's data while they access quantum cloud computing services.\nProfessor David Lucas, the co-head of the Oxford University Physics research team, said in a press release: 'We have shown for the first time that quantum computing in the cloud can be accessed in a scalable, practical way which will also give people complete security and privacy of data, plus the ability to verify its authenticity.'\nWhat is quantum cloud computing? Classical computers process information as binary bits represented as 1s and 0s, but quantum computers do so using quantum bits, or qubits. Qubits exist as both a 1 and a 0 at the same time, but with a probability of being one or the other that is determined by their quantum state. This property enables quantum computers to tackle certain calculations much faster than classical computers, as they can solve problems simultaneously.\nQuantum cloud computing is where quantum resources are provided to users remotely over the internet; this allows anyone to utilise quantum computing without the need for specialised hardware or expertise.\nFREE DOWNLOAD: Quantum computing: An insider's guide\nFREE DOWNLOAD: Quantum computing: An insider's guide Why is ‘blind quantum computing' more secure? With typical quantum cloud computing, the user must divulge the problem they are trying to solve to the cloud provider; this is because the provider's infrastructure needs to understand the specifics of the problem so it can allocate the appropriate resources and execution parameters. Naturally, in the case of proprietary work, this presents a security concern.\nThis security risk is minimised with the blind quantum computing method because the user remotely controls the quantum processor of the server themselves during a computation. The information required to keep the data secure — like the input, output and algorithmic details — only needs to be known by the client because the server does not make any decisions with it.\nHow blind quantum cloud computing works. 'Never in history have the issues surrounding privacy of data and code been more urgently debated than in the present era of cloud computing and artificial intelligence,' said Professor Lucas in the press release.\n'As quantum computers become more capable, people will seek to use them with complete security and privacy over networks, and our new results mark a step change in capability in this respect.'\nHow could quantum computing impact business? Quantum computing is vastly more powerful than conventional computing, and could revolutionise how we work if it is successfully scaled out of the research phase. Examples include solving supply chain problems, optimising routes and securing communications.\nIn February, the U.K. government announced a £45 million ($57 million) investment into quantum computing; the money goes toward finding practical uses for quantum computing and creating a 'quantum-enabled economy' by 2033. In March, quantum computing was singled out in the Ministerial Declaration, with G7 countries agreeing to work together to promote the development of quantum technologies and foster collaboration between academia and industry. Just this month, the U.K.'s second commercial quantum computer came online.\nDue to the extensive power and refrigeration requirements, very few quantum computers are currently commercially available. However, several leading cloud providers do offer so-called quantum-as-a-service to corporate clients and researchers. Google's Cirq, for example, is an open source quantum computing platform, while Amazon Braket allows users to test their algorithms on a local quantum simulator. IBM, Microsoft and Alibaba also have quantum-as-a-service offerings.\nWATCH: What classic software developers need to know about quantum computing\nWATCH: What classic software developers need to know about quantum computing But before quantum computing can be scaled up and used for business applications, it is imperative to ensure it can be achieved while safeguarding the privacy and security of customer data. This is what the Oxford University researchers hoped to achieve in their new study, published in Physical Review Letters.\nDr. Peter Dmota, study lead, told TechRepublic in an email: 'Strong security guarantees will lower the barrier to using powerful quantum cloud computing services, once available, to speed up the development of new technologies, such as batteries and drugs, and for applications that involve highly confidential data, such as private medical information, intellectual property, and defence. Those applications exist also without added security, but would be less likely to be used as widely.\n'Quantum computing has the potential to drastically improve machine learning. This would supercharge the development of better and more adapted artificial intelligence, which we are already seeing impacting businesses across all sectors.\n'It is conceivable that quantum computing will have an impact on our lives in the next five to ten years, but it is difficult to forecast the exact nature of the innovations to come. I expect a continuous adaptation process as users start to learn how to use this new tool and how to apply it to their jobs — similar to how AI is slowly becoming more relevant at the mainstream workplace right now.\n'Our research is currently driven by quite general assumptions, but as businesses start to explore the potential of quantum computing for them, more specific requirements will emerge and drive research into new directions.'\nHow does blind quantum cloud computing work? Blind quantum cloud computing requires connecting a client computer that can detect photons, or particles of light, to a quantum computing server with a fibre optic cable ( Figure B ). The server generates single photons, which are sent through the fibre network and received by the client.\nFigure B). The server generates single photons, which are sent through the fibre network and received by the client. Figure B\nFigure B The researchers connected a client computer that could detect photons, or particles of light, to a quantum computing server with a fibre optic cable. Image: David Nadlinger/Oxford University The client then measures the polarisation, or orientation, of the photons, which tells it how to remotely manipulate the server in a way that will produce the desired computation. This can be done without the server needing access to any information about the computation, making it secure.\nTo provide additional assurance that the results of the computation are not erroneous or have been tampered with, additional tests can be undertaken. While tampering would not harm the security of the data in a blind quantum computation, it could still corrupt the result and leave the client unaware.\n'The laws of quantum mechanics don't allow copying of information and any attempt to observe the state of the memory by the server or an eavesdropper would corrupt the computation,' Dr Dmota explained to TechRepublic in an email. 'In that case, the user would notice that the server isn't operating faithfully, using a feature called ‘verification', and abort using their service if there are any doubts.\n'Since the server is ‘blind' to the computation — ie, is not able to distinguish different computations — the client can evaluate the reliability of the server by running simple tests whose results can be easily checked.\n'These tests can be interleaved with the actual computation until there is enough evidence that the server is operating correctly and the results of the actual computation can be trusted to be correct. This way, honest errors as well as malicious attempts to tamper with the computation can be detected by the client.'\nFigure C\nFigure C Dr Peter Drmota (pictured) said that the research is 'a big step forward in both quantum computing and keeping our information safe online.' Image: Martin Small/Oxford University What did the researchers discover through their blind quantum cloud computing experiment? The researchers found the computations their method produced 'could be verified robustly and reliably', as per the paper. This means that the client can trust the results have not been tampered with. It is also scalable, as the number of quantum elements being manipulated for performing calculations can be increased 'without increasing the number of physical qubits in the server and without modifications to the client hardware,' the scientists wrote.\nDr. Drmota said in the press release, 'Using blind quantum computing, clients can access remote quantum computers to process confidential data with secret algorithms and even verify the results are correct, without revealing any useful information. Realising this concept is a big step forward in both quantum computing and keeping our information safe online.'\nThe research was funded by the UK Quantum Computing and Simulation Hub — a collaboration of 17 universities supported by commercial and government organisations. It is one of four quantum technology hubs in the UK National Quantum Technologies Programme.",
      "word_count": 1618,
      "is_opinion": false,
      "twitter_account": "@TechRepublic",
      "all_links": [
        "https://journals.aps.org/prl/abstract/10.1103/PhysRevLett.132.150604",
        "https://solutions.technologyadvice.com/meet-the-editorial-team/",
        "https://flipboard.com/@techrepublic/cybersecurity-and-cyberwar-r36o4ug0z",
        "https://ibm-research.medium.com/exxonmobil-ibm-scientists-explore-state-of-art-quantum-algorithms-to-solve-routing-formulations-e7ce39f8741c",
        "https://technologyadvice.com/privacy-policy/ccpa-opt-out-form/",
        "https://twitter.com/techrepublic",
        "https://www.youtube.com/techrepublic",
        "https://techrepublic.atlassian.net/servicedesk/customer/portal/2",
        "https://technologyadvice.com/terms-conditions/",
        "https://solutions.technologyadvice.com/advertise-on-techrepublic/?utm_source=techrepublic&utm_medium=portfolio_footer&utm_campaign=advertise_contact-us",
        "https://technologyadvice.com/careers/",
        "https://www.oxinst.com/news/rigetti-and-oxford-instruments-announce-successful-completion-of-innovate-uk-project-to-launch-one-of-the-first-uk-based-quantum-computers/",
        "https://www.physics.ox.ac.uk/about-us/media/latest-media-release",
        "https://technologyadvice.com/privacy-policy/",
        "https://www.nature.com/articles/s41586-020-03093-8",
        "https://www.facebook.com/TechRepublic",
        "https://www.honeywell.com/us/en/news/2021/01/exploring-supply-chain-solutions-with-quantum-computing"
      ],
      "all_domain_links": [
        "facebook.com",
        "technologyadvice.com",
        "twitter.com",
        "aps.org",
        "honeywell.com",
        "flipboard.com",
        "medium.com",
        "youtube.com",
        "oxinst.com",
        "nature.com",
        "atlassian.net",
        "ox.ac.uk"
      ],
      "id": "d92a6e149229c74baf1ae6f53a6d3414",
      "score": 9.935215
    }...
  ],
  "user_input": {
    "author_name": "\"Fiona Jackson\"",
    "not_author_name": null,
    "sources": null,
    "predefined_sources": null,
    "not_sources": null,
    "lang": null,
    "not_lang": null,
    "countries": null,
    "not_countries": null,
    "from_": "2024-04-17T00:00:00",
    "to_": "2024-04-24T08:56:41.304698",
    "published_date_precision": null,
    "by_parse_date": false,
    "sort_by": "relevancy",
    "ranked_only": null,
    "from_rank": null,
    "to_rank": null,
    "is_headline": null,
    "is_paid_content": null,
    "parent_url": null,
    "all_links": null,
    "all_domain_links": null,
    "word_count_min": null,
    "word_count_max": null,
    "page": 1,
    "page_size": 100,
    "include_nlp_data": null,
    "has_nlp": null,
    "theme": null,
    "not_theme": null,
    "ner_name": null,
    "title_sentiment_min": null,
    "title_sentiment_max": null,
    "content_sentiment_min": null,
    "content_sentiment_max": null,
    "iptc_tags": null,
    "not_iptc_tags": null,
    "iab_tags": null,
    "not_iab_tags": null
  }
}

406 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

{
    "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"
}

403: Forbidden Invalid API Key

{
    "message": "Forbidden",
    "code": 403
}

422: Unprocessable Entity Parameter is not allowed

{
    "message": "Param langs is not allowed for plan nlp"
}

Successful Request Response

{
    "status": "ok",
    "total_hits": 6969,
    "page": 1,
    "total_pages": 70,
    "page_size": 100,
    "articles": [
       {
      "title": "Rabbit sells more than 10,000 units of its extremely interesting pocket AI companion",
      "author": "Jak Connor",
      "authors": [
        "Jak Connor"
      ],
      "journalists": [
        "Jak Connor"
      ],
      "published_date": "2024-01-17 16:05:03",
      "published_date_precision": "full",
      "updated_date": null,
      "updated_date_precision": null,
      "link": "https://www.tweaktown.com/news/95657/rabbit-sells-more-than-10-000-units-of-its-extremely-interesting-pocket-ai-companion/index.html",
      "domain_url": "tweaktown.com",
      "full_domain_url": "tweaktown.com",
      "name_source": "TweakTown",
      "is_headline": true,
      "paid_content": false,
      "parent_url": "https://www.tweaktown.com/news",
      "country": "US",
      "rights": "tweaktown.com",
      "rank": 7324,
      "media": "https://static.tweaktown.com/news/9/5/95657_8481_rabbit_full.png",
      "language": "en",
      "description": "AI startup company Rabbit has announced that it has sold out two batches of its R1, an AI companion device designed to be a pocket virtual assistant.",
      "content": "AI startup company Rabbit has announced that it has sold out two batches of its R1, an AI companion device designed to be a pocket virtual assistant.\nStartup company Rabbit gained massive attention at the CES event this year and has had to open up a second production run of its new AI-powered pocket assistant, the R1, after it sold 10,000 units on the very first day of pre-orders. After just one day of pre-orders being live, Rabbit announced it has sold out of their first run of AI companions, taking to social platform X to say, \"When we started building R1, we said internally that we'd be happy if we sold 500 devices on launch day.\" absolutely smashing that they added, \"In 24 hours, we already beat that by 20x!\" Rabbit unveiled the funky orange pocket pal during a showcase on Tuesday, which comes with a 2.88-inch touchscreen and runs on Rabbits OS. The device uses its \"Large Action Model\" as a universal controller for apps to allow it to do things like play music, order an Uber, buy groceries, and send messages through one interface without the need for a phone or computer. The device is also trainable, allowing users to set how the R1 interacts with apps. 2 VIEW GALLERY - 2 IMAGES Although Rabbit is completely sold out on their first line of production, due between March and April of this year, you can still pre-order the R1 directly through Rabbit's website. Rabbit says consumers can expect the delivery date for the device to be between April and May of this year, meaning those who missed out on the first set of pre-orders won't have to wait very long.",
      "word_count": 283,
      "is_opinion": false,
      "twitter_account": "@TweakTown",
      "all_links": [
        "https://twitter.com/1/status/1745186588475502718",
        "https://click.linksynergy.com/deeplink?id=RZrrn*9L87M&mid=44583&murl=https://www.newegg.com",
        "https://www.amazon.com/dp/B0BY3J3ZPZ?tag=twea-20",
        "https://www.tweaktownforum.com",
        "https://www.amazon.com/dp/B07WTS8T2W?tag=twea-20",
        "https://www.amazon.com/dp/B0B469JRGC?tag=twea-20",
        "https://www.youtube.com/user/tweaktown?sub_confirmation=1",
        "https://www.amazon.com/dp/B00OAJ412U?tag=twea-20",
        "https://twitter.com/TweakTown",
        "https://www.amazon.com/dp/B07GCKQD77?tag=twea-20",
        "https://www.amazon.com/dp/B08166SLDF?tag=twea-20",
        "https://www.pinterest.com/tweaktown/",
        "https://www.amazon.com/dp/B07NY9ZRZG?tag=twea-20",
        "https://www.facebook.com/TweakTown",
        "https://www.amazon.com/dp/B0BLCBLCDR?tag=twea-20",
        "https://www.amazon.com/dp/B09WCHGP12?tag=twea-20",
        "https://www.amazon.com/dp/B07C438TMN?tag=twea-20&linkCode=ogi&th=1&psc=1",
        "https://www.amazon.com/dp/B07SZXBTNW?tag=twea-20",
        "https://www.amazon.com/dp/B0BP8B6M7Y?tag=twea-20",
        "https://www.theverge.com/2024/1/10/24033498/rabbit-r1-sold-out-ces-ai"
      ],
      "all_domain_links": [
        "tweaktownforum.com",
        "twitter.com",
        "facebook.com",
        "amazon.com",
        "theverge.com",
        "linksynergy.com",
        "pinterest.com",
        "youtube.com"
      ],
      "nlp": {
        "theme": "Business, Tech",
        "summary": "Rabbit sold 10,000 units of their pocket virtual assistant R1 on the first day of pre-orders. The R1 is an AI-powered device with a 2.88-inch touchscreen and runs on Rabbits OS. The first production run of the R1 sold out in 24 hours. The second production run will be ready between April and May.",
        "sentiment": {
          "title": 0,
          "content": 0.9992566704750061
        },
        "ner_PER": [],
        "ner_ORG": [
          {
            "entity_name": "Rabbit",
            "count": 7
          },
          {
            "entity_name": "Uber",
            "count": 1
          }
        ],
        "ner_MISC": [
          {
            "entity_name": "R1",
            "count": 5
          },
          {
            "entity_name": "CES",
            "count": 1
          },
          {
            "entity_name": "Rabbits OS",
            "count": 1
          },
          {
            "entity_name": "allowing",
            "count": 1
          },
          {
            "entity_name": "VIEW",
            "count": 1
          }
        ],
        "ner_LOC": [],
        "iptc_tags_name": [
          "science and technology / technology and engineering / agricultural technology",
          "economy, business and finance / products and services / consumer goods / consumer electronics",
          "economy, business and finance / business information / business strategy and marketing / new product or service"
        ],
        "iptc_tags_id": [
          "20000192",
          "20000205",
          "20000170",
          "13000000",
          "20000243",
          "04000000",
          "20001258",
          "20000756",
          "20000209",
          "20000759"
        ]
      },
      "id": "164de9168279ea19a096bc5e24428753",
      "score": 30.279182
    },
    ...
    ],
    "user_input": {...}
}

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
	authors	List of all author names
	journalists	Clean list of journalists. No news publishcation names, only people.
	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
	updated_date	Updated date & time
	updated_date_precision	Accuracy of the updated_datefield. 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
	domain_url	The domain URL of the article's source
	full_domain_url	The full domain URL with a subcategory of the article's source
	name_source	The common name of the News Source
	is_headline	True when an article has been seen on the main page of the news source.
	parent_url	The URL where an article was initially found
	country	The country of the publisher
	rights	Copyright
	rank	The page rank of the source website (which is given in the clean_url)
	media	A link to a thumbnail image of the article
	language	The language of the article
	description	Short summary of the article provided by the publisher
	content	The full content of the article
	word_count	Number of words in the article's content
	is_opinion	True if the article is an "Opinion" article
	twitter_account	The Twitter account of the publisher
	all_links	All URL links embedded in the article's content HTML
	all_domain_links	All domain URL embedded in the article's content HTML
	nlp	Depending on your plan your can have : - summary - sentiment - theme - ner - embeddings - iptc_tags_name - iptc_tags_ids
	id	Newscatcher API's unique identifier for each news article
	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
user_input		An object that returns how the API 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