Machine-readable docs: llms.txt (index), llms-full.txt (complete reference), OpenAPI specification.

NewsAPI.ai API Documentation | Endpoints, SDKs, and Key Access Explained: Access the complete API documentation for NewsAPI.ai. Learn about endpoints, parameters, Python and Node.js SDKs, rate limits, and response codes. Get started quickly with free registration and your API key.
Semantic Annotation API | Identify Entities in Text with NewsAPI.ai: Use NewsAPI.ai's annotation tool to uniquely identify people, locations, organizations, and concepts within documents. Supports over 100 languages with semantic annotations linked to Wikipedia pages.
Semantic Similarity API | Compare Cross-Language Document Similarity with NewsAPI.ai: Compare the semantic similarity between two documents in different languages with NewsAPI.ai's Semantic Similarity API. Identify shared entities and gain deep contextual insights.
Get Articles API | Search News and PR Content with Advanced Filters from NewsAPI.ai: Find news articles matching one or more search conditions with NewsAPI.ai's Get Articles API. Use advanced search parameters to retrieve the most relevant content, from keywords to locations.
Get Articles for Topic Page API | Topic-Based News Search with NewsAPI.ai: Retrieve news articles that match a user-generated topic page with NewsAPI.ai's Get Articles for Topic Page API. Use unique URIs to easily filter by concepts, keywords, news sources, and more.
Stream New News Articles in Real-Time with NewsAPI.ai: Access new articles added to Event Registry with NewsAPI.ai's 'Stream of New Articles' endpoint. Set up filters to get the latest news content directly to your application.
Search and Retrieve Events by Keyword or Concept with NewsAPI.ai: Discover events related to your interests with NewsAPI.ai. Use the Get Events endpoint to find events that match specific keywords, concepts, categories, and more.
Retrieve Events for User-Generated Topic Pages with NewsAPI.ai: Use NewsAPI.ai's Get Events for a Topic Page to retrieve events that match your user-generated topics. Customize searches with topic-specific URIs.
Retrieve Comprehensive Event Details with NewsAPI.ai: Obtain comprehensive details about specific events using NewsAPI.ai's Get Event Details endpoint. Retrieve articles, summaries, and other event metadata.
Access Real-Time Stream of Events with NewsAPI.ai: Access real-time streams of events added or updated in the last few minutes with NewsAPI.ai's Stream of Events endpoint. Filter by language, keywords, or locations.
Retrieve the Latest Breaking Events with NewsAPI.ai: Get a list of the most recent breaking events with NewsAPI.ai's Breaking Events endpoint. Retrieve events based on their breaking score and reporting intensity.
Suggest Concepts for API Queries with NewsAPI.ai: Find concept URIs with NewsAPI.ai's Suggest Concepts API. Retrieve concept details for various API queries by searching partial or full concept labels.
Suggest Categories for API Queries with NewsAPI.ai: Retrieve category URIs with NewsAPI.ai's Suggest Categories API. Search for categories by partial or full label to assist in filtering various API calls.
Suggest News Sources for API Queries with NewsAPI.ai: Use NewsAPI.ai's Suggest Sources API to retrieve news source URIs. Search by source name or domain name to assist in filtering API requests.
Suggest Authors for API Queries with NewsAPI.ai: Find author URIs with NewsAPI.ai's Suggest Authors API. Retrieve authors by name, including partial matches, to assist in API queries.
Suggest Locations for API Queries with NewsAPI.ai: Retrieve location URIs using NewsAPI.ai's Suggest Locations API. Search by city or country name to get relevant URIs for API filtering.
Suggest Event Types for API Queries with NewsAPI.ai: Find event type URIs with NewsAPI.ai's Suggest Event Types API. Retrieve event types for API calls by providing a label or prefix.
Terminology and Definitions for NewsAPI.ai & Event Registry: Explore terminology used in Event Registry and NewsAPI.ai. Learn about articles, events, concepts, categories, sources, and locations for API queries.
Supported Languages and Language Codes | NewsAPI.ai: See the full list of languages supported by NewsAPI.ai and Event Registry, with the language codes to use in the lang parameter of your API calls.
Advanced Search Query Language | NewsAPI.ai Documentation: Build advanced NewsAPI.ai queries with AND, OR and NOT logic. Learn the JSON query language to combine keywords, concepts, categories, sources and filters.
Keyword Search Modes — Phrase, Boolean & Simple | NewsAPI.ai: Learn NewsAPI.ai's keyword search modes: exact phrase matching, full Boolean logic (AND/OR/NOT, NEAR, NEXT), and relevance-based simple search, with examples.
Response Format and Data Models | NewsAPI.ai Documentation: Understand the response format of NewsAPI.ai. Explore the data models for articles, events, concepts, categories, sources and other returned JSON objects.
MCP Integration Guide | NewsAPI.ai for AI Assistants: Connect NewsAPI.ai to Claude, Codex, Cursor and other AI assistants with the hosted Model Context Protocol (MCP) server. Search news, track events, find mentions and use topic pages.
n8n Integration Overview | NewsAPI.ai Automation: Automate news workflows with NewsAPI.ai and n8n. Learn how to set up API credentials and connect Event Registry endpoints to no-code n8n automations.
n8n Example: Content Research Workflow | NewsAPI.ai: Build a content research assistant with NewsAPI.ai and n8n. Step-by-step workflow to fetch, split and email relevant news articles automatically.
n8n Example: News Alert System | NewsAPI.ai: Create a news alert system with NewsAPI.ai and n8n. Schedule searches, filter results with conditions, and send email alerts for breaking news automatically.
n8n Example: Sentiment Analysis Workflow | NewsAPI.ai: Track news sentiment with NewsAPI.ai and n8n. Build a workflow that collects articles, extracts sentiment, and logs results to Google Sheets for analysis.
Named entity recognition | Event Registry API documentation: Reference for the Named entity recognition endpoint of the Event Registry API: parameters, request examples and the response format.
Categorize | Event Registry API documentation: Reference for the Categorize endpoint of the Event Registry API: parameters, request examples and the response format.
Sentiment | Event Registry API documentation: Reference for the Sentiment endpoint of the Event Registry API: parameters, request examples and the response format.
Extract article information | Event Registry API documentation: Reference for the Extract article information endpoint of the Event Registry API: parameters, request examples and the response format.
Detect language | Event Registry API documentation: Reference for the Detect language endpoint of the Event Registry API: parameters, request examples and the response format.
Get article details | Event Registry API documentation: Reference for the Get article details endpoint of the Event Registry API: parameters, request examples and the response format.
Get mentions | Event Registry API documentation: Reference for the Get mentions endpoint of the Event Registry API: parameters, request examples and the response format.
API Usage | Event Registry API documentation: Reference for the API Usage endpoint of the Event Registry API: parameters, request examples and the response format.

Categorize

Categorize the content into a set of predefined categories.

The API call can be used to compute a list of predefined categories that summarize your content. There are two taxonomies of categories that can be used - dmoz and news.

The dmoz taxonomy contains over 5000 categories and can only be used for documents in English language. It is organized into 3 levels and go from more general to more specific topics.

The news taxonomy contains only 8 top level categories commonly used to categorize the news content, but can be applied on any language. The categorization into both taxonomies can work well only on documents of decent size (like news articles).

The iptc subject codes contain over 1,000 categories organized into 3 levels. The taxonomy is maintained by IPTC standards body of the news media.

EndpointGET | POSThttp://analytics.eventregistry.org/api/v1/categorize

HeadersContent-Type: application/json

Categorize the input text using the DMOZ taxonomy.

Request body

            
            {
  "text": "Microsoft released a new version of Windows OS.",
  "taxonomy": "dmoz",
  "apiKey": "YOUR_API_KEY"
}

Categorize the input text using the news taxonomy.

Request body

            
            {
  "text": "Coronavirus live news: global cases pass 5m as EU health chief warns of second wave.",
  "taxonomy": "news",
  "apiKey": "YOUR_API_KEY"
}

            
            {
  "categories": [
    {
      "label": "dmoz/Society/Politics/Campaigns_and_Elections",
      "score": 0.1590137586442502
    },
    {
      "label": "dmoz/Society/Issues/Government_Operations",
      "score": 0.09788376841818867
    },
    {
      "label": "dmoz/Sports/Running/Training",
      "score": 0.09113215743926972
    },
    {
      "label": "dmoz/Society/Politics",
      "score": 0.08833645912765467
    },
    {
      "label": "dmoz/Sports/Running/Women",
      "score": 0.08633878749684593
    }
  ],
  "keywords": [
    {
      "keyword": "Society",
      "wgt": 0.1562750829170778
    },
    {
      "keyword": "Politics",
      "wgt": 0.133749498823212
    },
    {
      "keyword": "Campaigns_and_Elections",
      "wgt": 0.104674684563492
    }
  ]
}

            
            {
  "type": "object",
  "properties": {
    "categories": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "label": {
            "type": "string",
            "example": "dmoz/Business/Investing/Stocks_and_Bonds"
          },
          "score": {
            "type": "double",
            "example": 0.123
          }
        }
      }
    },
    "keywords": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "keyword": {
            "type": "string",
            "example": "Investing"
          },
          "wgt": {
            "type": "double",
            "example": 0.24
          }
        }
      }
    }
  }
}

Parameters

apiKey string (required)

Your API key

text string (required)

Define a text that you'll like to see categorized.

taxonomy string (required)

Define the taxonomy in which you'll want to categorize the selected text

Available values: dmoz, news, iptc

Categorize

Request body

Request body

Example output

Output schema