Event Registry · Example Payload

Search Events

Example request and response for searching clustered news events about Climate Change using /event/getEvents.

NewsMedia MonitoringNews IntelligenceEvent DetectionNamed Entity RecognitionSentiment AnalysisMedia AnalyticsNews API

Search Events is an example object payload from Event Registry, with 4 top-level fields. It illustrates the shape of data this provider's APIs accept or return.

Top-level fields

titledescriptionrequestresponse

Example Payload

{
  "title": "Search Events by Concept",
  "description": "Example request and response for searching clustered news events about Climate Change using /event/getEvents.",
  "request": {
    "method": "POST",
    "url": "https://eventregistry.org/api/v1/event/getEvents",
    "headers": {
      "Content-Type": "application/json"
    },
    "body": {
      "apiKey": "YOUR_API_KEY",
      "conceptUri": "http://en.wikipedia.org/wiki/Climate_change",
      "dateStart": "2026-05-01",
      "lang": "eng",
      "eventsSortBy": "size",
      "eventsCount": 3,
      "minArticlesInEvent": 10,
      "resultType": "events"
    }
  },
  "response": {
    "status": 200,
    "body": {
      "events": {
        "results": [
          {
            "uri": "eng-9876543",
            "title": {
              "eng": "UN Climate Summit 2026: World Leaders Agree on Emission Cuts"
            },
            "summary": {
              "eng": "World leaders at the UN Climate Summit in June 2026 reached a landmark agreement on accelerated emission reduction targets, with 150 countries signing the accord..."
            },
            "articleCount": 3421,
            "date": "2026-06-05",
            "dateStart": "2026-06-01",
            "dateEnd": "2026-06-12",
            "sentiment": -0.12,
            "location": {
              "uri": "http://en.wikipedia.org/wiki/New_York_City",
              "label": { "eng": "New York City" },
              "type": "city",
              "lat": 40.7128,
              "long": -74.006
            },
            "concepts": [
              {
                "uri": "http://en.wikipedia.org/wiki/Climate_change",
                "type": "wiki",
                "score": 100,
                "label": { "eng": "Climate change" }
              },
              {
                "uri": "http://en.wikipedia.org/wiki/United_Nations",
                "type": "org",
                "score": 85,
                "label": { "eng": "United Nations" }
              }
            ],
            "categories": [
              {
                "uri": "dmoz/Science/Environment",
                "label": "Environment",
                "wgt": 100
              }
            ]
          }
        ],
        "totalResults": 892,
        "page": 1,
        "count": 3
      }
    }
  }
}

Work with this as data

Every example 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 examples

4 MCP tools reach this

find_examplesBrowse and filter every example in the catalog.
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 example

curl "https://apis.io/api/v1/examples/search-events"

All examples

curl "https://apis.io/api/v1/examples?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.