{ "opencollection": "1.0.0", "info": { "name": "Local News AggregationCount API", "version": "1.2.0" }, "request": { "auth": { "type": "apikey", "key": "x-api-token", "value": "{{x-api-token}}", "placement": "header" } }, "items": [ { "info": { "name": "AggregationCount", "type": "folder" }, "items": [ { "info": { "name": "Get aggregation count by interval", "type": "http" }, "http": { "method": "GET", "url": "https://local-news.newscatcherapi.com/api/aggregation_count", "params": [ { "name": "q", "value": "", "type": "query" }, { "name": "aggregation_by", "value": "", "type": "query" }, { "name": "search_in", "value": "", "type": "query" }, { "name": "predefined_sources", "value": "", "type": "query", "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": "sources", "value": "", "type": "query", "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.\n" }, { "name": "not_sources", "value": "", "type": "query", "description": "The news sources to exclude from the search. To exclude multiple sources, use a comma-separated string.\n" }, { "name": "lang", "value": "", "type": "query", "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.\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", "value": "", "type": "query", "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": "countries", "value": "", "type": "query", "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.\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", "value": "", "type": "query", "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_author_name", "value": "", "type": "query", "description": "The list of author names to exclude from your search. To exclude articles by specific authors, use a comma-separated string.\n" }, { "name": "from_", "value": "", "type": "query" }, { "name": "to_", "value": "", "type": "query" }, { "name": "published_date_precision", "value": "", "type": "query" }, { "name": "by_parse_date", "value": "", "type": "query" }, { "name": "sort_by", "value": "date", "type": "query" }, { "name": "ranked_only", "value": "", "type": "query" }, { "name": "from_rank", "value": "", "type": "query" }, { "name": "to_rank", "value": "", "type": "query" }, { "name": "is_headline", "value": "", "type": "query" }, { "name": "is_opinion", "value": "", "type": "query" }, { "name": "is_paid_content", "value": "", "type": "query" }, { "name": "parent_url", "value": "", "type": "query", "description": "The categorical URL(s) to filter your search. To filter your search by multiple categorical URLs, use a comma-separated string.\n" }, { "name": "all_links", "value": "", "type": "query", "description": "The complete URL(s) mentioned in the article. For multiple URLs, use a comma-separated string.\n\nFor more details, see [Search by URL](https://www.newscatcherapi.com/docs/news-api/how-to/search-by-url).\n" }, { "name": "all_domain_links", "value": "", "type": "query", "description": "The domain(s) mentioned in the article. For multiple domains, use a comma-separated string.\n\nFor more details, see [Search by URL](https://www.newscatcherapi.com/docs/news-api/how-to/search-by-url).\n" }, { "name": "all_links_text", "value": "", "type": "query", "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.\n\n**Note**: When this parameter is used, the response includes the `all_links_data` field with detailed link information.\n\nTo learn more, see [Search by URL](https://www.newscatcherapi.com/docs/news-api/how-to/search-by-url).\n" }, { "name": "word_count_min", "value": "", "type": "query" }, { "name": "word_count_max", "value": "", "type": "query" }, { "name": "page", "value": "", "type": "query" }, { "name": "page_size", "value": "", "type": "query" }, { "name": "include_nlp_data", "value": "", "type": "query" }, { "name": "has_nlp", "value": "", "type": "query" }, { "name": "theme", "value": "", "type": "query" }, { "name": "not_theme", "value": "", "type": "query" }, { "name": "ORG_entity_name", "value": "", "type": "query" }, { "name": "PER_entity_name", "value": "", "type": "query" }, { "name": "LOC_entity_name", "value": "", "type": "query" }, { "name": "MISC_entity_name", "value": "", "type": "query" }, { "name": "title_sentiment_min", "value": "", "type": "query" }, { "name": "title_sentiment_max", "value": "", "type": "query" }, { "name": "content_sentiment_min", "value": "", "type": "query" }, { "name": "content_sentiment_max", "value": "", "type": "query" }, { "name": "iptc_tags", "value": "", "type": "query", "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": "not_iptc_tags", "value": "", "type": "query", "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.\n\n**Note**: The `not_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": "robots_compliant", "value": "", "type": "query" } ] }, "docs": "Retrieves the count of articles aggregated by day or hour based on various search criteria, such as keyword, language, country, and source." }, { "info": { "name": "Get aggregation count by interval", "type": "http" }, "http": { "method": "POST", "url": "https://local-news.newscatcherapi.com/api/aggregation_count", "body": { "type": "json", "data": "{}" } }, "docs": "Retrieves the count of articles aggregated by day or hour based on various search criteria, such as keyword, language, country, and source." } ] } ], "bundled": true }