Event Registry

Event Registry Suggest API

Resolve entity names to URIs for use in search filters.

GitHub OpenAPI

Operations 5

POST /suggestConceptsFast Suggest concept URIs by name prefix #
POST /suggestCategoriesFast Suggest category URIs by name prefix #
POST /suggestSourcesFast Suggest news source URIs by name prefix #
POST /suggestLocationsFast Suggest location URIs by name prefix #
POST /suggestAuthorsFast Suggest author URIs by name prefix #

Documentation

📖
Documentation
https://newsapi.ai/documentation
📖
Documentation
https://github.com/EventRegistry/newsapi-mcp

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/event-registry/refs/heads/main/openapi/event-registry-suggest-api-openapi.yml

Other Resources

🔗
Overlay
https://raw.githubusercontent.com/api-evangelist/event-registry/refs/heads/main/overlays/event-registry-suggest-overlay.yaml
🔗
PostmanCollection
https://raw.githubusercontent.com/api-evangelist/event-registry/refs/heads/main/collections/event-registry-suggest-api.postman_collection.json
🔗
OpenCollection
https://raw.githubusercontent.com/api-evangelist/event-registry/refs/heads/main/collections/event-registry-suggest-api.opencollection.json
🔗
Sandbox
https://newsapi.ai/documentation/sandbox
🔗
PythonSDK
https://github.com/EventRegistry/event-registry-python
🔗
NodeSDK
https://github.com/EventRegistry/event-registry-node-js

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/event-registry-suggest-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

event-registry-suggest-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Event Registry (NewsAPI.ai) Articles Suggest API
  description: 'Event Registry (NewsAPI.ai) is the world''s leading news intelligence platform providing a REST API for accessing global news articles, trending topics, event detection, named entities, sentiment analysis, and media monitoring across 150,000+ sources in 60+ languages, with historical archive access dating back to 2014. All requests are POST with JSON bodies and require an apiKey field.

    '
  version: 1.0.0
  contact:
    name: Event Registry Support
    email: info@eventregistry.org
    url: https://newsapi.ai
  termsOfService: https://newsapi.ai/terms
  license:
    name: Proprietary
    url: https://newsapi.ai/plans
servers:
- url: https://eventregistry.org/api/v1
  description: Production API server
security:
- apiKeyAuth: []
tags:
- name: Suggest
  description: Resolve entity names to URIs for use in search filters.
paths:
  /suggestConceptsFast:
    post:
      operationId: suggestConcepts
      summary: Suggest concept URIs by name prefix
      description: 'Look up concept URIs (people, organizations, locations, things) by name prefix. Always resolve entity names to URIs using this endpoint before passing them to conceptUri filters in search operations.

        '
      tags:
      - Suggest
      requestBody:
        required: true
        content:
          application/json:
            schema:
              allOf:
              - $ref: '#/components/schemas/ApiKeyParam'
              properties:
                prefix:
                  type: string
                  description: Short name prefix to search for (1-3 words). Performs prefix matching.
                lang:
                  type: string
                  description: Language for label display and matching. Default "eng".
                conceptType:
                  type: string
                  description: Filter by concept type — "person", "org", "loc", "wiki".
              required:
              - prefix
            example:
              apiKey: YOUR_API_KEY
              prefix: Tesla
              lang: eng
      responses:
        '200':
          description: List of matching concept suggestions with URIs.
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/SuggestResult'
        '401':
          description: Unauthorized.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
  /suggestCategoriesFast:
    post:
      operationId: suggestCategories
      summary: Suggest category URIs by name prefix
      description: 'Look up news topic category URIs (business, tech, sports, etc.) by name prefix. Use returned URIs in categoryUri filters.

        '
      tags:
      - Suggest
      requestBody:
        required: true
        content:
          application/json:
            schema:
              allOf:
              - $ref: '#/components/schemas/ApiKeyParam'
              properties:
                prefix:
                  type: string
                  description: Short category name prefix to search for.
                lang:
                  type: string
                  description: Language for label display. Default "eng".
              required:
              - prefix
            example:
              apiKey: YOUR_API_KEY
              prefix: Business
      responses:
        '200':
          description: List of matching category suggestions with URIs.
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/SuggestResult'
        '401':
          description: Unauthorized.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
  /suggestSourcesFast:
    post:
      operationId: suggestSources
      summary: Suggest news source URIs by name prefix
      description: 'Look up news source URIs (e.g., Reuters, BBC) by name prefix. Use returned URIs in sourceUri filters.

        '
      tags:
      - Suggest
      requestBody:
        required: true
        content:
          application/json:
            schema:
              allOf:
              - $ref: '#/components/schemas/ApiKeyParam'
              properties:
                prefix:
                  type: string
                  description: Short source name prefix to search for.
                lang:
                  type: string
                  description: Language for matching. Default "eng".
              required:
              - prefix
            example:
              apiKey: YOUR_API_KEY
              prefix: Reuters
      responses:
        '200':
          description: List of matching source suggestions with URIs.
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/SuggestResult'
        '401':
          description: Unauthorized.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
  /suggestLocationsFast:
    post:
      operationId: suggestLocations
      summary: Suggest location URIs by name prefix
      description: 'Look up location URIs (countries, cities, regions) by name prefix. Use returned URIs in locationUri or sourceLocationUri filters. Always use English location names.

        '
      tags:
      - Suggest
      requestBody:
        required: true
        content:
          application/json:
            schema:
              allOf:
              - $ref: '#/components/schemas/ApiKeyParam'
              properties:
                prefix:
                  type: string
                  description: Short location name prefix in English.
                lang:
                  type: string
                  description: Language for label display. Default "eng".
              required:
              - prefix
            example:
              apiKey: YOUR_API_KEY
              prefix: Germany
      responses:
        '200':
          description: List of matching location suggestions with URIs.
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/SuggestResult'
        '401':
          description: Unauthorized.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
  /suggestAuthorsFast:
    post:
      operationId: suggestAuthors
      summary: Suggest author URIs by name prefix
      description: 'Look up journalist/author URIs by name prefix. Use returned URIs in authorUri filters.

        '
      tags:
      - Suggest
      requestBody:
        required: true
        content:
          application/json:
            schema:
              allOf:
              - $ref: '#/components/schemas/ApiKeyParam'
              properties:
                prefix:
                  type: string
                  description: Short author name prefix to search for.
                lang:
                  type: string
                  description: Language for matching. Default "eng".
              required:
              - prefix
            example:
              apiKey: YOUR_API_KEY
              prefix: John Smith
      responses:
        '200':
          description: List of matching author suggestions with URIs.
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/SuggestResult'
        '401':
          description: Unauthorized.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
components:
  schemas:
    SuggestResult:
      type: object
      properties:
        uri:
          type: string
          description: Unique URI for the entity, for use in search filters.
        label:
          type: object
          additionalProperties:
            type: string
          description: Display label keyed by language code.
        type:
          type: string
          description: Entity type (concept, source, location, category, author).
    ApiKeyParam:
      type: object
      required:
      - apiKey
      properties:
        apiKey:
          type: string
          description: Your NewsAPI.ai API key.
    ErrorResponse:
      type: object
      properties:
        error:
          type: string
        message:
          type: string
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      in: query
      name: apiKey
      description: 'API key obtained from newsapi.ai/register. Include as a field in the JSON POST body or as a query parameter named apiKey.

        '
externalDocs:
  description: Official API Documentation
  url: https://newsapi.ai/documentation