Introduction
API endpoints
Annotate Named entity recognition Categorize Semantic similarity Sentiment Extract article information Detect language
Get articles Get articles for topic page Get article details Stream of new articles
Get events Get events for a topic page Get event details Stream of events Get list of breaking events
Get mentions
Suggest concepts Suggest categories Suggest sources Suggest authors Suggest locations Suggest event types
API Usage
Reference
Terminology
Supported languages
Response format
Building queries
Search query language
Keyword search modes
Integrations
MCP Integration
OverviewExample 1Example 2Example 3

Suggest concepts

Try in sandbox  

Retrieve the concept URI for a given concept label/prefix.

Use this API endpoint to map the concept label into the concept URI that can be used when specifying the conceptUri filter in various API calls. The label does not have to be a full name - the partial name will also return a list of concept URIs that match the provided text.

The returned value will contain an array of concepts that match the input label. The concepts are sorted based on how frequently they occur in Event Registry data. Most often, the first candidate is the value you want to use.

Endpointhttps://eventregistry.org/api/v1/suggestConceptsFast
HeadersContent-Type: application/json

Find the list of concepts, whose label matches the term "Obama". The matching is case-insensitive and the concept does not need to start with the term ("Obama" can be a term anywhere in the label of the concept).

Request body

Parameters 
apiKey  string (required)

Your API key

prefix  string

Partial or full name of the concept.

lang  string | string[] (required)

What the prefix is matched against. An ISO3 language code matches the concept labels in that language. ticker, isin and cik match a company's stock ticker symbol, its ISIN or its SEC Central Index Key (without the leading zeros), and domain matches an organization's domain name (e.g. apple.com). You can specify several values.

Available values:  eng, spa, deu, zho, slv, cat, por, ita, fra, rus, ara, hrv, srp, ticker, isin, cik, domain
Example value:  eng