Search and Monitor Worldwide Cryptocurrency-related news and blog data from the most reliable News and Blog Websites. Retrieving the latest news allows you to build experience such as showcasing the latest news, breaking news tickers and analyzing News to better understand their content.
Resource URL
https://newsdata.io/api/1/crypto?apikey=YOUR_API_KEY
Response Format
JSON
Authentication
Required
Rate Limited
1800 Credits
per 15 min (Paid Plans)
Request Parameters
Below are the request parameters available to filter and customise your API query.
| Name | Required | Description | Default | Example |
|---|---|---|---|---|
Search & Content Filters | ||||
qInTitle | OPTIONAL | Search news articles for specific keywords or phrases present in the news titles only. The value must be URL-encoded and the maximum character limit permitted is 512 characters. Note: qInTitle can't be used with q or qInMeta parameter in the same query. | - | qInTitle=pizza |
qInMeta | OPTIONAL | Search news articles for specific keywords or phrases present in the news titles, URL, meta keywords and meta description only. The value must be URL-encoded and the maximum character limit permitted is 512 characters. Note: qInMeta can't be used with q or qInTitle parameter in the same query. | - | qInMeta=pizza |
q | OPTIONAL | Search news articles for specific keywords or phrases present in the news title, content, URL, meta keywords and meta description. The value must be URL-encoded and the maximum character limit permitted is 512 characters. | - | q=pizza |
id | OPTIONAL | Search the specific news article from its unique article_id string. You can add up to 50 article id strings in a single query or as per your specified limit. | - | id=article_id id=article_id_1,article_id_2, article_id_3 |
url | OPTIONAL | You can search for a specific news article by providing its URL. | - | url=https://newsdata.io/blog/multiple-api-key-newsdata-io |
tag | OPTIONAL | Search the news articles for specific AI-classified tags. Include up to 10 tags per query. With Custom AI Tags (Corporate Yearly Plan only), you can request your own tag to classify articles based on your specific topic or tag | - | tag=blockchain |
coin | OPTIONAL | Search the news articles for a specific language. Include up to 5 coins per query on Free and Basic plans. Professional and Corporate plans support up to 10 coins | - | coin=btc coin=eth,usdt,bnb |
sentiment | OPTIONAL | Search the news articles based on the sentiment of the news article (positive, negative, neutral). | - | sentiment=positive |
Location, Language & Time Filters | ||||
language | OPTIONAL | Search the news articles for a specific language. Include up to 5 languages per query on Free and Basic plans. Professional and Corporate plans support up to 10 languages. | - | language=fr,en,ga |
excludelanguage | OPTIONAL | You can exclude specific languages to search for news articles. Exclude up to 5 languages per query on Free and Basic plans. Professional and Corporate plans support up to 10 languages. Note: You can use either the 'language' parameter to include specific languages or the 'excludelanguage' parameter to exclude them, but not both simultaneously. | - | excludelanguage=fr,en,ga |
timeframe | OPTIONAL | Search the news articles for a specific timeframe (Minutes and Hours). For hours, you can set a timeframe of 1 to 48, and for minutes, you can define a timeframe of 1m to 2880m. For example, if you want to get the news for the past 6 hours then use timeframe=6 and if you want to get news for the last 15 min then use timeframe=15m. Note - You can only use timeframe either in hours or minutes. | - | For Hours - timeframe=1 timeframe=6 timeframe=24 For Minutes - timeframe=15m timeframe=45m timeframe=90m |
timezone | OPTIONAL | Search the news articles for a specific timezone. You can add any specific timezone. | - | timezone=America/New_york timezone=Asia/Kolkata timezone=Asia/Qatar timezone=Europe/Berli |
from_date | OPTIONAL | Use from_date filter to get news data from a particular date in the past. Note: If you didn’t specify from_date then from_date will be considered as per your subscription plan. For example, if you have purchased the professional subscription plan and didn’t mention from_date then the API will automatically fetch the data from the past 1 year. | - | from_date=YYYY-MM-DD from_date=2025-01-01 from_date=YYYY-MM-DD HH:MM:SS from_date=2025-01-01 06:12:45 |
to_date | OPTIONAL | This filter is used to set an end date for the search result. Note: If you didn't specify to_date then the API will fetch the data till today | - | to_date=YYYY-MM-DD to_date=2025-01-30 to_date=YYYY-MM-DD HH:MM:SS to_date=2025-01-30 06:12:45 |
Source, Quality & Intelligence Controls | ||||
domainurl | OPTIONAL | Search the news articles for specific domains or news sources. Include up to 5 domains per query on Free and Basic plans. Professional and Corporate plans support up to 10 domains. Note: If the domain is incorrect, It will give suggestions in the response | - | domainurl=blockchain.news, cointelegraph.com |
excludedomainurl | OPTIONAL | You can exclude specific domains or news sources to search the news articles. Exclude up to 5 domains per query on Free and Basic plans. Professional and Corporate plans support up to 10 domains. Note: If the domain is incorrect, It will give suggestions in the response | - | excludedomainurl=blockchain.news, cointelegraph.com |
prioritydomain | OPTIONAL | Search the news articles only from top news domains. We have categorized prioritydomain in 3 categories. Top: Fetches news articles from the top 10% of the news domains Medium: Fetches news articles from the top 30% of the news domains. It means it already includes all the news articles of 'top' priority. Low: Fetches news articles from the top 50% of the news domains. It means it already includes all the news articles of 'top' and 'medium' priorities. | - | prioritydomain=top prioritydomain=medium prioritydomain=low |
image | OPTIONAL | Search the news articles with featured image or without featured image. Use 1 for articles with featured image and 0 for articles without featured image. | - | image=1 image=0 |
video | OPTIONAL | Search the news articles with videos or without videos. Use 1 for articles with videos and 0 for articles without videos. | - | video=1 video=0 |
full_content | OPTIONAL | Search the news articles with full content or without full content. Use '1' for news articles which contain the full_content response object and '0' for news articles which don't contain full_content response object. | - | full_content=1 full_content=0 |
removeduplicate | OPTIONAL | The 'removeduplicate' parameter will allow users to filter out duplicate articles. Use 1 to remove duplicate articles. (Note: The overall 'removeduplicate' parameter functioning works on the basis of Newsdata.io's internal algorithm. It doesn't imply that the article which has a 'removeduplicate=1' parameter is actually a duplicate article.) | - | removeduplicate=1 |
Request Control & Response Handling | ||||
apikey | Required | You need to add your API Key while accessing the newsdata API. | - | - |
sort | OPTIONAL | You can sort the search results based on your preferred criteria to organize how news articles appear in the response. You can use the sort parameter with one of the following options: pubdateasc – Sort articles by publish date in ascending order (oldest to newest). relevancy – Sort articles by most relevant results first based on your query. source – Sort results by source priority (top to low). fetched_at - Sort articles by their fetched date. Note: By default, results are sorted by publish date (newest first) if no sort parameter is specified. | - | sort=relevancy sort=fetched_at |
size | OPTIONAL | You can customize the number of articles you get per API request from 1 to 50. | Free user - 10 Paid user - 50 | size=25 |
page | OPTIONAL | Use page parameter to navigate to the next page. To know more: | - | - |
excludefield | OPTIONAL | you can limit the response object to search for news articles. You can exclude multiple response objects in a single query. Note: You cannot exclude article ID from the response field | - | excludefield=pubdate excludefield=source_icon, pubdate,link |
Example Queries
1. Crypto News related to Bitcoin only
https://newsdata.io/api/1/crypto?apikey=YOUR_API_KEY&coin=btc
2. Crypto News in Italian and Japanese language
https://newsdata.io/api/1/crypto?apikey=YOUR_API_KEY&language=it,jp
3. Crypto News from the domainurl coindesk.com
https://newsdata.io/api/1/crypto?apikey=YOUR_API_KEY&domainurl=blockchain.news,cointelegraph.com
See also
Crypto News API EndpointsWas this page helpful?