v1

latestOpenAPI 3.1.0Proprietary2026-07-1391579.5 KB
Count

Cryptocurrency article count

Returns the number of cryptocurrency news articles matching the filters. With interval=all (default) a single total is returned; with interval=hour or interval=day a count-per-hour/day breakdown is returned. from_date and to_date are required. Available on plans with count access.

Consumes 50 API credits per call.

get/1/crypto/count

Query parameters

apikeystring

Your API key. Alternatively send it in the X-ACCESS-KEY HTTP header. One of the two MUST be present.

qstring

Search articles by keywords or phrases (matches title, description, content, keywords, and URL). Supports AND / OR operators and quoted phrases. Maximum length depends on your plan (default 100 characters). Use only one of q, qInTitle, qInMeta.

qInTitlestring

Search articles by keywords in the title only. Maximum length depends on your plan (default 100 characters). Use only one of q, qInTitle, qInMeta.

qInMetastring

Search articles by keywords in the title, description, keywords, and URL. Maximum length depends on your plan (default 100 characters). Use only one of q, qInTitle, qInMeta.

coinstring[]

Filter by cryptocurrency. Comma-separated coin ticker symbols, up to your plan's filter limit (default 5).

languagestring[]

Filter by language. Comma-separated ISO 639-1 language codes, up to your plan's filter limit (default 5). Cannot be combined with excludelanguage.

excludelanguagestring[]

Exclude languages. Comma-separated language codes, up to your plan's filter limit (default 5). Cannot be combined with language.

domainstring[]

Filter by news source. Comma-separated source ids (the id value returned by /1/sources), up to your plan's filter limit (default 5). Cannot be combined with domainurl or excludedomain.

domainurlstring[]

Filter by news source domain, e.g. bbc.com. Comma-separated, up to your plan's filter limit (default 5). Cannot be combined with domain or excludedomain.

excludedomainstring[]

Exclude news source domains, e.g. bbc.com. Comma-separated, up to your plan's filter limit (default 5). Cannot be combined with domain or domainurl.

prioritydomain'top' | 'medium' | 'low'

Restrict results to a tier of news sources ranked by quality and popularity: top, medium, or low.

from_datestring required

Count articles published on or after this date. Format YYYY-MM-DD or YYYY-MM-DD HH:MM:SS (UTC). Cannot be a future date. How far back you can go depends on your plan.

to_datestring required

Count articles published on or before this date. Format YYYY-MM-DD or YYYY-MM-DD HH:MM:SS (UTC). Cannot be a future date.

image'0' | '1'

Set to 1 to return only articles that include an image, or 0 to leave the image_url field out of the response.

video'0' | '1'

Set to 1 to return only articles that include a video, or 0 to leave the video_url field out of the response.

full_content'0' | '1'

Set to 1 to return only articles that include full content, or 0 to leave the content field out of the response. Available on plans with full-content access.

removeduplicate'0' | '1'

Set to 1 to exclude duplicate articles. Available for dates from 2024-07-24 onward.

sentiment'positive' | 'neutral' | 'negative'

Filter articles by sentiment. Available on Professional and Corporate plans, for dates from 2024-01-12 onward.

tagstring[]

Filter by AI-classified topic tags (e.g. politics,technology). Comma-separated, up to your plan's filter limit (default 5). Available on Professional and Corporate plans, for dates from 2024-01-12 onward.

interval'all' | 'hour' | 'day'

How to count: all (default) returns a single total; hour or day returns a count-per-hour or count-per-day breakdown.

sizeinteger

Number of histogram entries per page when interval=hour or day: 1 to 50 on paid plans, 1 to 10 on the free plan.

pagestring

Pagination for the histogram. Pass the nextPage value from the previous response.

sort'pubdatedesc' | 'pubdateasc'

Ordering of the histogram: pubdatedesc (default, newest first) or pubdateasc.

Response

Success. The shape depends on the interval parameter.

OR