Operations to aggregate news counts.
openapi: 3.0.3
info:
title: Local News AggregationCount API
description: 'The Local News API provides access to local news articles with location-specific filtering capabilities.
## Standard endpoints
- `/search`: Search articles by keywords with simple location filtering ("City, State" format).
- `/latest_headlines`: Retrieve recent articles for specified locations and time periods.
- `/search_by`: Retrieve articles by URL, ID, or RSS GUID.
- `/sources`: List available news sources.
## Advanced endpoints
- `/search/advanced`: Search with structured GeoNames filtering.
- `/latest_headlines/advanced`: Latest headlines with structured GeoNames filtering.
## Features
- Multiple location detection methods including dedicated sources, proximity analysis, and AI extraction
- Natural language processing for sentiment analysis and entity recognition on original content and English translations
- Article clustering for topic analysis
- English translations for non-English content
'
termsOfService: https://newscatcherapi.com/terms-of-service
contact:
name: Maksym Sugonyaka
email: maksym@newscatcherapi.com
url: https://www.newscatcherapi.com/book-a-demo
version: 1.2.0
servers:
- url: https://local-news.newscatcherapi.com
description: Local News API production server
security:
- ApiKeyAuth: []
tags:
- name: AggregationCount
description: Operations to aggregate news counts.
externalDocs:
description: Aggregate news counts based on specified criteria such as keyword, language, country, source, and more.
url: https://www.newscatcherapi.com/docs/news-api/api-reference/aggregation-count/get-aggregation-count-by-interval-get
paths:
/api/aggregation_count:
get:
x-fern-sdk-group-name: aggregation_count
x-fern-sdk-method-name: get
tags:
- AggregationCount
summary: Get aggregation count by interval
description: Retrieves the count of articles aggregated by day or hour based on various search criteria, such as keyword, language, country, and source.
operationId: aggregationCountGet
parameters:
- $ref: '#/components/parameters/Q'
- $ref: '#/components/parameters/AggregationBy'
- $ref: '#/components/parameters/SearchIn'
- $ref: '#/components/parameters/PredefinedSources'
- $ref: '#/components/parameters/Sources'
- $ref: '#/components/parameters/NotSources'
- $ref: '#/components/parameters/Lang'
- $ref: '#/components/parameters/NotLang'
- $ref: '#/components/parameters/Countries'
- $ref: '#/components/parameters/NotCountries'
- $ref: '#/components/parameters/NotAuthorName'
- $ref: '#/components/parameters/From'
- $ref: '#/components/parameters/To'
- $ref: '#/components/parameters/PublishedDatePrecision'
- $ref: '#/components/parameters/ByParseDate'
- $ref: '#/components/parameters/SortBy'
- $ref: '#/components/parameters/RankedOnly'
- $ref: '#/components/parameters/FromRank'
- $ref: '#/components/parameters/ToRank'
- $ref: '#/components/parameters/IsHeadline'
- $ref: '#/components/parameters/IsOpinion'
- $ref: '#/components/parameters/IsPaidContent'
- $ref: '#/components/parameters/ParentUrl'
- $ref: '#/components/parameters/AllLinks'
- $ref: '#/components/parameters/AllDomainLinks'
- $ref: '#/components/parameters/AllLinksText'
- $ref: '#/components/parameters/WordCountMin'
- $ref: '#/components/parameters/WordCountMax'
- $ref: '#/components/parameters/Page'
- $ref: '#/components/parameters/PageSize'
- $ref: '#/components/parameters/IncludeNlpData'
- $ref: '#/components/parameters/HasNlp'
- $ref: '#/components/parameters/Theme'
- $ref: '#/components/parameters/NotTheme'
- $ref: '#/components/parameters/OrgEntityName'
- $ref: '#/components/parameters/PerEntityName'
- $ref: '#/components/parameters/LocEntityName'
- $ref: '#/components/parameters/MiscEntityName'
- $ref: '#/components/parameters/TitleSentimentMin'
- $ref: '#/components/parameters/TitleSentimentMax'
- $ref: '#/components/parameters/ContentSentimentMin'
- $ref: '#/components/parameters/ContentSentimentMax'
- $ref: '#/components/parameters/IptcTags'
- $ref: '#/components/parameters/NotIptcTags'
- $ref: '#/components/parameters/RobotsCompliant'
responses:
'200':
$ref: '#/components/responses/AggregationCountResponse'
'400':
$ref: '#/components/responses/BadRequestError'
'401':
$ref: '#/components/responses/UnauthorizedError'
'403':
$ref: '#/components/responses/ForbiddenError'
'408':
$ref: '#/components/responses/RequestTimeoutError'
'422':
$ref: '#/components/responses/ValidationError'
'429':
$ref: '#/components/responses/RateLimitError'
'500':
$ref: '#/components/responses/InternalServerError'
post:
x-fern-sdk-group-name: aggregation_count
x-fern-sdk-method-name: post
tags:
- AggregationCount
summary: Get aggregation count by interval
description: Retrieves the count of articles aggregated by day or hour based on various search criteria, such as keyword, language, country, and source.
operationId: aggregationCountPost
requestBody:
$ref: '#/components/requestBodies/AggregationRequestBody'
responses:
'200':
$ref: '#/components/responses/AggregationCountResponse'
'400':
$ref: '#/components/responses/BadRequestError'
'401':
$ref: '#/components/responses/UnauthorizedError'
'403':
$ref: '#/components/responses/ForbiddenError'
'408':
$ref: '#/components/responses/RequestTimeoutError'
'422':
$ref: '#/components/responses/ValidationError'
'429':
$ref: '#/components/responses/RateLimitError'
'500':
$ref: '#/components/responses/InternalServerError'
components:
parameters:
Sources:
description: 'One or more news sources to narrow down the search. The format must be a domain URL. Subdomains, such as `finance.yahoo.com`, are also acceptable.To specify multiple sources, use a comma-separated string.
'
name: sources
in: query
required: false
schema:
type: string
example: nytimes.com,finance.yahoo.com
OrgEntityName:
name: ORG_entity_name
in: query
required: false
schema:
$ref: '#/components/schemas/OrgEntityName'
NotSources:
description: 'The news sources to exclude from the search. To exclude multiple sources, use a comma-separated string.
'
name: not_sources
in: query
required: false
schema:
type: string
example: cnn.com,wsj.com
Page:
name: page
in: query
required: false
schema:
$ref: '#/components/schemas/Page'
PredefinedSources:
description: "Predefined top news sources per country. \n\nFormat: start with the word `top`, followed by the number of desired sources, and then the two-letter country code [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2). \n\nMultiple countries with the number of top sources can be specified as a comma-separated string.\n"
name: predefined_sources
in: query
required: false
schema:
type: string
example: top 50 US, top 20 GB
TitleSentimentMin:
name: title_sentiment_min
in: query
required: false
schema:
$ref: '#/components/schemas/TitleSentimentMin'
NotLang:
description: "The language(s) to exclude from the search. The accepted format is the two-letter [ISO 639-1](https://en.wikipedia.org/wiki/ISO_639-1) code. To exclude multiple languages, use a comma-separated string. \n\nTo learn more, see [Enumerated parameters > Language](https://www.newscatcherapi.com/docs/news-api/api-reference/enumerated-parameters#language-lang-and-not-lang).\n"
name: not_lang
in: query
required: false
schema:
type: string
example: fr,de
Countries:
description: 'The countries where the news publisher is located. The accepted format is the two-letter [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) code. To select multiple countries, use a comma-separated string.
To learn more, see [Enumerated parameters > Country](https://www.newscatcherapi.com/docs/news-api/api-reference/enumerated-parameters#country-country-and-not-country).
'
name: countries
in: query
required: false
schema:
type: string
example: US,CA
ParentUrl:
description: 'The categorical URL(s) to filter your search. To filter your search by multiple categorical URLs, use a comma-separated string.
'
name: parent_url
in: query
required: false
schema:
type: string
example: wsj.com/politics,wsj.com/tech
NotAuthorName:
description: 'The list of author names to exclude from your search. To exclude articles by specific authors, use a comma-separated string.
'
name: not_author_name
in: query
required: false
schema:
type: string
example: John Doe, Jane Doe
ContentSentimentMax:
name: content_sentiment_max
in: query
required: false
schema:
$ref: '#/components/schemas/ContentSentimentMax'
PageSize:
name: page_size
in: query
required: false
schema:
$ref: '#/components/schemas/PageSize'
IsOpinion:
name: is_opinion
in: query
required: false
schema:
$ref: '#/components/schemas/IsOpinion'
Theme:
name: theme
in: query
required: false
schema:
$ref: '#/components/schemas/Theme'
AllDomainLinks:
description: 'The domain(s) mentioned in the article. For multiple domains, use a comma-separated string.
For more details, see [Search by URL](https://www.newscatcherapi.com/docs/news-api/how-to/search-by-url).
'
name: all_domain_links
in: query
required: false
schema:
type: string
example: who.int,nih.gov
WordCountMax:
name: word_count_max
in: query
required: false
schema:
$ref: '#/components/schemas/WordCountMax'
PerEntityName:
name: PER_entity_name
in: query
required: false
schema:
$ref: '#/components/schemas/PerEntityName'
WordCountMin:
name: word_count_min
in: query
required: false
schema:
$ref: '#/components/schemas/WordCountMin'
Lang:
description: 'The language(s) of the search. The only accepted format is the two-letter [ISO 639-1](https://en.wikipedia.org/wiki/ISO_639-1) code. To select multiple languages, use a comma-separated string.
To learn more, see [Enumerated parameters > Language](https://www.newscatcherapi.com/docs/news-api/api-reference/enumerated-parameters#language-lang-and-not-lang).
'
name: lang
in: query
required: false
schema:
type: string
example: en,es
IncludeNlpData:
name: include_nlp_data
in: query
required: false
schema:
$ref: '#/components/schemas/IncludeNlpData'
IsHeadline:
name: is_headline
in: query
required: false
schema:
$ref: '#/components/schemas/IsHeadline'
AggregationBy:
name: aggregation_by
in: query
required: false
schema:
$ref: '#/components/schemas/AggregationBy'
PublishedDatePrecision:
name: published_date_precision
in: query
required: false
schema:
$ref: '#/components/schemas/PublishedDatePrecision'
TitleSentimentMax:
name: title_sentiment_max
in: query
required: false
schema:
$ref: '#/components/schemas/TitleSentimentMax'
AllLinks:
description: 'The complete URL(s) mentioned in the article. For multiple URLs, use a comma-separated string.
For more details, see [Search by URL](https://www.newscatcherapi.com/docs/news-api/how-to/search-by-url).
'
name: all_links
in: query
required: false
schema:
type: string
example: https://aiindex.stanford.edu/report,https://www.stateof.ai
SearchIn:
name: search_in
in: query
required: false
schema:
$ref: '#/components/schemas/SearchIn'
IsPaidContent:
name: is_paid_content
in: query
required: false
schema:
$ref: '#/components/schemas/IsPaidContent'
To:
name: to_
in: query
required: false
schema:
$ref: '#/components/schemas/To'
SortBy:
name: sort_by
in: query
required: false
schema:
$ref: '#/components/schemas/SortBy'
example: date
MiscEntityName:
name: MISC_entity_name
in: query
required: false
schema:
$ref: '#/components/schemas/MiscEntityName'
LocEntityName:
name: LOC_entity_name
in: query
required: false
schema:
$ref: '#/components/schemas/LocEntityName'
RankedOnly:
name: ranked_only
in: query
required: false
schema:
$ref: '#/components/schemas/RankedOnly'
NotIptcTags:
description: 'Inverse of the `iptc_tags` parameter. Excludes articles based on International Press Telecommunications Council (IPTC) media topic tags. To specify multiple IPTC tags to exclude, use a comma-separated string of tag IDs.
**Note**: The `not_iptc_tags` parameter is only available in the `v3_nlp_iptc_tags` subscription plan.
To learn more, see [IPTC Media Topic NewsCodes](https://www.iptc.org/std/NewsCodes/treeview/mediatopic/mediatopic-en-GB.html).
'
name: not_iptc_tags
in: query
required: false
schema:
type: string
example: 20000205,20000209
RobotsCompliant:
name: robots_compliant
in: query
required: false
schema:
$ref: '#/components/schemas/RobotsCompliant'
From:
name: from_
in: query
required: false
schema:
$ref: '#/components/schemas/From'
NotCountries:
description: "The publisher location countries to exclude from the search. The accepted format is the two-letter [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) code. To exclude multiple countries, use a comma-separated string. \n\nTo learn more, see [Enumerated parameters > Country](https://www.newscatcherapi.com/docs/news-api/api-reference/enumerated-parameters#country-country-and-not-country).\n"
name: not_countries
in: query
required: false
schema:
type: string
example: UK,FR
ByParseDate:
name: by_parse_date
in: query
required: false
schema:
$ref: '#/components/schemas/ByParseDate'
AllLinksText:
description: 'The text content of links mentioned in the article. Searches for links where the anchor text contains the specified terms. For multiple terms, use a comma-separated string.
**Note**: When this parameter is used, the response includes the `all_links_data` field with detailed link information.
To learn more, see [Search by URL](https://www.newscatcherapi.com/docs/news-api/how-to/search-by-url).
'
name: all_links_text
in: query
required: false
schema:
type: string
example: Nvidia,Tesla
IptcTags:
description: "Filters articles based on International Press Telecommunications Council (IPTC) media topic tags. To specify multiple IPTC tags, use a comma-separated string of tag IDs. \n\n**Note**: The `iptc_tags` parameter is only available in the `v3_nlp_iptc_tags` subscription plan.\n\nTo learn more, see [IPTC Media Topic NewsCodes](https://www.iptc.org/std/NewsCodes/treeview/mediatopic/mediatopic-en-GB.html).\n"
name: iptc_tags
in: query
required: false
schema:
type: string
example: 20000199,20000209
Q:
name: q
in: query
required: true
schema:
$ref: '#/components/schemas/Q'
FromRank:
name: from_rank
in: query
required: false
schema:
$ref: '#/components/schemas/FromRank'
NotTheme:
name: not_theme
in: query
required: false
schema:
$ref: '#/components/schemas/NotTheme'
HasNlp:
name: has_nlp
in: query
required: false
schema:
$ref: '#/components/schemas/HasNlp'
ContentSentimentMin:
name: content_sentiment_min
in: query
required: false
schema:
$ref: '#/components/schemas/ContentSentimentMin'
ToRank:
name: to_rank
in: query
required: false
schema:
$ref: '#/components/schemas/ToRank'
schemas:
RankedOnly:
type: boolean
default: true
description: 'If true, limits the search to sources ranked in the top 1 million online websites. If false, includes unranked sources which are assigned a rank of 999999.
'
example: true
SearchIn:
type: string
default: title_content
description: "The article fields to search in. Use a comma-separated string for multiple options, with a maximum of 2 in a single request.\n\nAvailable options: \n- Standard fields: `title`, `content`, `summary`, `title_content`\n- Translation fields: `title_translated`, `content_translated`, `summary_translated`, `title_content_translated`\n"
example: title_content, title_content_translated
NotAuthorName:
oneOf:
- type: string
example: John Doe, Jane Doe
- type: array
items:
type: string
example:
- John Doe
- Jane Doe
description: 'The list of author names to exclude from your search. To exclude articles by specific authors, use a comma-separated string or an array of strings.
'
IptcTags:
oneOf:
- type: string
example: 20000199,20000209
- type: array
items:
type: string
example:
- '20000199'
- '20000209'
description: "Filters articles based on International Press Telecommunications Council (IPTC) media topic tags. To specify multiple IPTC tags, use a comma-separated string or an array of strings. \n\n**Note**: The `iptc_tags` parameter is only available in the `v3_nlp_iptc_tags` subscription plan.\n\nTo learn more, see [IPTC Media Topic NewsCodes](https://www.iptc.org/std/NewsCodes/treeview/mediatopic/mediatopic-en-GB.html).\n"
Page:
type: integer
minimum: 1
default: 1
description: "The page number to scroll through the results. Use for pagination, as a single API response can return up to 1,000 articles. \n\nFor details, see [Retrieve large datasets](https://www.newscatcherapi.com/docs/news-api/how-to/retrieve-more-than-10k-articles)\n"
example: 2
Lang:
oneOf:
- type: string
example: en,es
- type: array
items:
type: string
example:
- en
- es
description: 'The language(s) of the search. The only accepted format is the two-letter [ISO 639-1](https://en.wikipedia.org/wiki/ISO_639-1) code. To select multiple languages, use a comma-separated string or an array of strings.
To learn more, see [Enumerated parameters > Language](https://www.newscatcherapi.com/docs/news-api/api-reference/enumerated-parameters#language-lang-and-not-lang).
'
NotLang:
oneOf:
- type: string
example: fr,de
- type: array
items:
type: string
example:
- fr
- de
description: 'The language(s) to exclude from the search. The accepted format is the two-letter [ISO 639-1](https://en.wikipedia.org/wiki/ISO_639-1) code. To exclude multiple languages, use a comma-separated string or an array of strings.
To learn more, see [Enumerated parameters > Language](https://www.newscatcherapi.com/docs/news-api/api-reference/enumerated-parameters#language-lang-and-not-lang).
'
AggregationBy:
type: string
enum:
- day
- hour
- month
description: 'The aggregation interval for the results.
'
default: day
ToRank:
type: integer
minimum: 1
maximum: 999999
default: 999999
format: int32
description: 'The highest boundary of the rank of a news website to filter by. A lower rank indicates a more popular source.
'
example: 100
UserInputDto:
type: object
description: The user input parameters for the request.
additionalProperties: true
LocEntityName:
type: string
description: "Filters articles that mention specific location names, as identified by NLP analysis.\n\n- To specify multiple locations, use `AND`, `OR`, `NOT` operators, and `\\\"` escape literals for exact matches. \n- To search in translations, combine with the translation options of the `search_in` parameter (e.g., `title_content_translated`).\n\nTo learn more, see [Search by entity](https://www.newscatcherapi.com/docs/news-api/how-to/search-by-entity).\n"
example: '"San Francisco" OR "New York City"'
Countries:
oneOf:
- type: string
example: US,CA
- type: array
items:
type: string
example:
- US
- CA
description: 'The countries where the news publisher is located. The accepted format is the two-letter [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) code. To select multiple countries, use a comma-separated string or an array of strings.
To learn more, see [Enumerated parameters > Country](https://www.newscatcherapi.com/docs/news-api/api-reference/enumerated-parameters#country-country-and-not-country).
'
AllLinks:
oneOf:
- type: string
example: https://aiindex.stanford.edu/report/, https://www.stateof.ai/
- type: array
items:
type: string
example:
- https://aiindex.stanford.edu/report/
- https://www.stateof.ai/
description: 'The complete URL(s) mentioned in the article. For multiple URLs, use a comma-separated string or an array of strings.
For more details, see [Search by URL](https://www.newscatcherapi.com/docs/news-api/how-to/search-by-url).
'
FromRank:
type: integer
minimum: 1
maximum: 999999
default: 1
format: int32
description: 'The lowest boundary of the rank of a news website to filter by. A lower rank indicates a more popular source.
'
example: 100
WordCountMin:
type: integer
minimum: 0
description: 'The minimum number of words an article must contain. To be used for avoiding articles with small content.
'
example: 300
IsPaidContent:
type: boolean
description: 'Filters articles by content completeness.
If false, returns only articles for which full-text content is publicly available. If true, returns all indexed articles, including those where only partial content is publicly available (e.g., headlines, summaries, or preview paragraphs from paywalled sources).
**Note**: NewsCatcher indexes content that is publicly accessible and available for crawling in accordance with publisher access controls (e.g., robots.txt and similar mechanisms). For paywalled sources, only content that publishers make publicly available (such as headlines, summaries, or preview text) is indexed. NewsCatcher does not bypass paywalls, authentication systems, or other technical access restrictions.
'
example: false
AllLinksText:
oneOf:
- type: string
example: Nvidia, Tesla
- type: array
items:
type: string
example:
- Nvidia
- Tesla
description: 'The text content of links mentioned in the article. Searches for links where the anchor text contains the specified terms. For multiple terms, use a comma-separated string or an array of strings.
**Note**: When this parameter is used, the response includes the `all_links_data` field with detailed link information.
For more details, see [Search by URL](https://www.newscatcherapi.com/docs/news-api/how-to/search-by-url).
'
Q:
type: string
description: 'The keyword(s) to search for in articles. Query syntax supports logical operators (`AND`, `OR`, `NOT`) and wildcards:
- For exact phrases, use escaped quotes: `\"technology news\"`
- Use `*` for wildcards: `technolog*` (cannot start with `*`)
- Use `+` to include and `-` to exclude: `+Apple`, `-Google`
- Boolean operators: `technology AND (Apple OR Microsoft) NOT Google`
- Forbidden characters: `[` `]` `/` `\\` `:` `^` and URL-encoded equivalents
**Note:** The API automatically inserts `AND` operators between standalone terms, so strings like `"machine learning"` become `"machine AND learning"`. To avoid syntax errors (especially in queries with `OR` operators), use literal escape `"\"machine learning\""`.
For detailed syntax rules, see [Advanced querying](https://www.newscatcherapi.com/docs/news-api/guides-and-concepts/advanced-querying).
'
example: '"supply chain" AND Amazon NOT China'
NotTheme:
type: string
example: Crime,Sports
description: 'Inverse of the `theme` parameter. Excludes articles based on their general topic, as determined by NLP analysis. To exclude multiple themes, use a comma-separated string.
To learn more, see [NLP features](https://www.newscatcherapi.com/docs/news-api/guides-and-concepts/nlp-features).
'
BaseSearchResponseDto:
title: Base Search Response
description: The base response model containing common fields for search operations.
required:
- status
- total_hits
- page
- total_pages
- page_size
type: object
properties:
status:
title: Status
description: The status of the response.
type: string
total_hits:
title: Total Hits
description: The total number of articles matching the search criteria.
type: integer
page:
title: Page
description: The current page number of the results.
type: integer
total_pages:
title: Total Pages
description: The total number of pages available for the given search criteria.
type: integer
page_size:
title: Page Size
description: The number of articles per page.
type: integer
PublishedDatePrecision:
type: string
description: 'The precision of the published date. There are three types:
- `full`: The day and time of an article is correctly identified with the appropriate timezone.
- `timezone unknown`: The day and time of an article is correctly identified without timezone.
- `date`: Only the day is identified without an exact time.
'
example: full
TitleSentimentMax:
type: number
format: float
minimum: -1.0
maximum: 1.0
description: 'Filters articles based on the maximum sentiment score of their titles.
Range is `-1.0` to `1.0`, where:
- Negative values indicate negative sentiment.
- Positive values indicate positive sentiment.
- Values close to 0 indicate neutral sentiment.
To learn more, see [NLP features](https://www.newscatcherapi.com/docs/news-api/guides-and-concepts/nlp-features).
'
example: 0.5
RobotsCompliant:
type: boolean
description: 'If true, returns only articles that comply with the publisher''s robots.txt rules. If false, returns only articles that do not comply with robots.txt rules. If omitted, returns all articles regardless of compliance status.
'
example: true
ByParseDate:
type: boolean
default: false
description: 'If true, the `from_` and `to_` parameters use article parse dates instead of published dates. Additionally, the `parse_date` variable is added to the output for each article object.
'
example: true
PredefinedSources:
oneOf:
- type: string
example: top 50 US, top 20 GB
- type: array
items:
type: string
example:
- top 50 US
- top 20 GB
description: "Predefined top news sources per country. \n\nFormat: start with the word `top`, followed by the number of desired sources, and then the two-letter country code [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2). \n\nMultiple countries with the number of top sources can be specified as a comma-separated string or an array of strings.\n"
Error:
type: object
properties:
message:
type: string
description: A detailed description of the error.
status_code:
type: integer
description: The HTTP status code of the error.
status:
type: string
description: A short description of the status code.
required:
- message
- status_code
- status
AllDomainLinks:
oneOf:
- type: string
example: who.int, nih.gov
- type: array
items:
type: string
example:
- who.int
- nih.gov
description: 'The domain(s) mentioned in the article. For multiple domains, use a comma-separated string or an array of strings.
For more details, see [Search by URL](https://www.newscatcherapi.com/docs/news-api/how-to/search-by-url).
'
IncludeNlpData:
type: boolean
default: false
description: 'If true, includes an NLP object for each article in the response. This object provides results of NLP analysis, including article theme, summary, sentiment, tags, and named entity recognition if available.
**Note**: NLP data is only available for articles indexed from July 2023 onward. For articles indexed before July 2023, the `nlp` field is returned as an empty object `{}`.
To learn more, see [NLP features](https://www.newscatcherapi.com/docs/news-api/guides-and-concepts/nlp-features).
'
example: true
AggregationItem:
title: Aggregation Item
description: 'A single item in the aggregations array containing a collection of time-based article counts.
'
required:
- aggregation_count
type: object
properties:
aggregation_count:
type: array
description: Array of time frames and their corresponding article counts
items:
$ref: '#/components/schemas/TimeFrameCount'
OrgEntityName:
type: string
description: "Filters articles that mention specific organization names, as identified by NLP analysis. \n\n- To specify multiple organizations, use `AND`, `OR`, `NOT` operators, and `\\\"` escape literals for exact matches. \n- To search in translations, combine with the translation options of the `search_in` parameter (e.g., `title_content_translated`).\n\nTo learn more, see [Search by entity](https://www.newscatcherapi.com/docs/news-api/how-to/search-by-entity).\n"
example: '"Apple Inc" OR Microsoft'
PerEntityName:
type: string
description: "Filters articles that mention specific person names, as identified by NLP analysis. \n\n- To specify multiple names, use `AND`, `OR`, `NOT` operators, and `\\\"` escape literals for exact matches. \n- To search in translations, combine with the translation options of the `search_in` parameter (e.g., `title_content_translated`).\n\nTo learn more, see [Search by entity](https://www.newscatcherapi.com/docs/news-api/how-to/search-by-entity).\n"
example: '"Elon Musk" OR "Jeff Bezos"'
ContentSentimentMax:
type: number
format: float
minimum: -1.0
maximum: 1.0
description: 'Filters articles based on the maximum sentiment score of their content.
Range is `-1.0` to `1.
# --- truncated at 32 KB (49 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/newscatcher/refs/heads/main/openapi/newscatcher-aggregationcount-api-openapi.yml