Sign in
Count

Financial-market article count

Returns the number of financial-market 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/market/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.

market_idstring[]

Filter by market identifier (market_id, the unique symbol id). Comma-separated, up to your plan's filter limit (default 5).

countrystring[]

Filter by country. Comma-separated ISO 3166-1 alpha-2 country codes, up to your plan's filter limit (default 5). Cannot be combined with excludecountry.

excludecountrystring[]

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

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 return the image_url field as null.

video'0' | '1'

Set to 1 to return only articles that include a video, or 0 to return the video_url field as null.

full_content'0' | '1'

Set to 1 to return only articles that include full content, or 0 to return the content field as null. 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.

sentiment_scorenumber

Minimum sentiment confidence (1-100) for the chosen sentiment. Requires the sentiment parameter.

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.

organizationstring[]

Filter by AI-extracted organization names. Comma-separated, up to your plan's filter limit (default 5). Available on Corporate plans, for dates from 2024-05-24 onward.

creatorstring[]

Filter by article author / byline. Comma-separated, up to your plan's filter limit (default 5).

datatypestring[]

Filter by content type, e.g. news, blog, podcast. Comma-separated, up to your plan's filter limit (default 5). Available for dates from 2025-11-28 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

Changes

Changed in 2 of the 3 revisions of this API.2215

  • ece1fd088c7314See the full diff
    • ○

      added the optional property results/oneOf[InvalidFilterDetail]/recommendations to the response with the 400 status

      response-optional-property-added

    • ○

      added the optional property results/oneOf[InvalidFilterDetail]/recommendations to the response with the 401 status

      response-optional-property-added

    • ○

      added the optional property results/oneOf[InvalidFilterDetail]/recommendations to the response with the 403 status

      response-optional-property-added

    • ○

      added the optional property results/oneOf[InvalidFilterDetail]/recommendations to the response with the 422 status

      response-optional-property-added

    • ○

      added the optional property results/oneOf[InvalidFilterDetail]/recommendations to the response with the 429 status

      response-optional-property-added

    • ○

      added the optional property results/oneOf[InvalidFilterDetail]/recommendations to the response with the 500 status

      response-optional-property-added

    • ○

      added the optional property results/oneOf[InvalidFilterDetail]/recommendations to the response with the 503 status

      response-optional-property-added

    • ○

      added the optional property results/oneOf[subschema #3]/items/recommendations to the response with the 400 status

      response-optional-property-added

    • ○

      added the optional property results/oneOf[subschema #3]/items/recommendations to the response with the 401 status

      response-optional-property-added

    • ○

      added the optional property results/oneOf[subschema #3]/items/recommendations to the response with the 403 status

      response-optional-property-added

    • ○

      added the optional property results/oneOf[subschema #3]/items/recommendations to the response with the 422 status

      response-optional-property-added

    • ○

      added the optional property results/oneOf[subschema #3]/items/recommendations to the response with the 429 status

      response-optional-property-added

    • ○

      added the optional property results/oneOf[subschema #3]/items/recommendations to the response with the 500 status

      response-optional-property-added

    • ○

      added the optional property results/oneOf[subschema #3]/items/recommendations to the response with the 503 status

      response-optional-property-added

  • 692a9e161b3f221See the full diff
    • ●

      deleted the query request parameter symbol

      request-parameter-removed

    • ●

      added the new Conflict enum value to the results/oneOf[ErrorDetail]/code response property for the response status 400

      response-property-enum-value-added

    • ●

      added the new Conflict enum value to the results/oneOf[ErrorDetail]/code response property for the response status 401

      response-property-enum-value-added

    • ●

      added the new Conflict enum value to the results/oneOf[ErrorDetail]/code response property for the response status 403

      response-property-enum-value-added

    • ●

      added the new Conflict enum value to the results/oneOf[ErrorDetail]/code response property for the response status 422

      response-property-enum-value-added

    • ●

      added the new Conflict enum value to the results/oneOf[ErrorDetail]/code response property for the response status 429

      response-property-enum-value-added

    • ●

      added the new Conflict enum value to the results/oneOf[ErrorDetail]/code response property for the response status 500

      response-property-enum-value-added

    • ●

      added the new Conflict enum value to the results/oneOf[ErrorDetail]/code response property for the response status 503

      response-property-enum-value-added

    • ●

      added the new Conflict enum value to the results/oneOf[InvalidFilterDetail]/code response property for the response status 400

      response-property-enum-value-added

    • ●

      added the new Conflict enum value to the results/oneOf[InvalidFilterDetail]/code response property for the response status 401

      response-property-enum-value-added

    • ●

      added the new Conflict enum value to the results/oneOf[InvalidFilterDetail]/code response property for the response status 403

      response-property-enum-value-added

    • ●

      added the new Conflict enum value to the results/oneOf[InvalidFilterDetail]/code response property for the response status 422

      response-property-enum-value-added

    • ●

      added the new Conflict enum value to the results/oneOf[InvalidFilterDetail]/code response property for the response status 429

      response-property-enum-value-added

    • ●

      added the new Conflict enum value to the results/oneOf[InvalidFilterDetail]/code response property for the response status 500

      response-property-enum-value-added

    • ●

      added the new Conflict enum value to the results/oneOf[InvalidFilterDetail]/code response property for the response status 503

      response-property-enum-value-added

    • ●

      added the new Conflict enum value to the results/oneOf[subschema #3]/items/code response property for the response status 400

      response-property-enum-value-added

    • ●

      added the new Conflict enum value to the results/oneOf[subschema #3]/items/code response property for the response status 401

      response-property-enum-value-added

    • ●

      added the new Conflict enum value to the results/oneOf[subschema #3]/items/code response property for the response status 403

      response-property-enum-value-added

    • ●

      added the new Conflict enum value to the results/oneOf[subschema #3]/items/code response property for the response status 422

      response-property-enum-value-added

    • ●

      added the new Conflict enum value to the results/oneOf[subschema #3]/items/code response property for the response status 429

      response-property-enum-value-added

    • ●

      added the new Conflict enum value to the results/oneOf[subschema #3]/items/code response property for the response status 500

      response-property-enum-value-added

    • ●

      added the new Conflict enum value to the results/oneOf[subschema #3]/items/code response property for the response status 503

      response-property-enum-value-added

    • ○

      added the new optional query request parameter market_id

      new-optional-request-parameter