Tools (6)

get_historical_event
search_historical_events
list_events_by_era
list_events_by_category
list_events_by_year_range
report_feedback

get_historical_event

Get a single historical event by its ID.

Returns detailed information including title, date, era, category, region,
description, and significance.

Parameter	Type	Required	Description
`event_id`	`string`	required	Event slug ID (e.g. 'moon-landing-1969', 'magna-carta').

Request Body

{
  "event_id": "example"
}

search_historical_events

Search historical events by keyword.

Searches across event titles and descriptions. Case-insensitive. Results are
sorted chronologically.

Parameter	Type	Required	Description
`query`	`string`	required	Search keyword — matches event title and description.
`limit`	`any`	optional	Maximum number of results (default: 20, max: 100).

Request Body

{
  "query": "example"
}

list_events_by_era

List historical events filtered by era.

Valid eras: Ancient, Medieval, Early Modern, Modern, Contemporary.
Results are sorted chronologically.

Parameter	Type	Required	Description
`era`	`string`	required	Era name: Ancient, Medieval, Early Modern, Modern, or Contemporary.
`limit`	`any`	optional	Maximum number of results (default: 50, max: 100).

Request Body

{
  "era": "example"
}

list_events_by_category

List historical events filtered by category.

Valid categories: War & Conflict, Science & Technology, Politics, Exploration,
Culture, Economics, Religion, Natural Disaster. Results sorted chronologically.

Parameter	Type	Required	Description
`category`	`string`	required	Category: War & Conflict, Science & Technology, Politics, Exploration, Culture, Economics, Religion, or Natural Disaster.
`limit`	`any`	optional	Maximum number of results (default: 50, max: 100).

Request Body

{
  "category": "example"
}

list_events_by_year_range

List historical events within a year range (inclusive).

Use negative years for BCE dates. Results sorted chronologically.

Parameter	Type	Required	Description
`start_year`	`integer`	required	Start year (use negative values for BCE, e.g. -500).
`end_year`	`integer`	required	End year (use negative values for BCE, e.g. -100).
`limit`	`any`	optional	Maximum number of results (default: 50, max: 100).

Request Body

{
  "start_year": 1,
  "end_year": 1
}

report_feedback

Report a bug, feature request, or general feedback for this data source.

Use this when something doesn't work as expected, when you'd like
a new feature, or when you have suggestions for improvement.

Args:
feedback: Describe the issue or suggestion.
feedback_type: One of 'bug', 'feature_request', or 'general'.

Parameter	Type	Required	Description
`feedback`	`string`	required
`feedback_type`	`string`	optional	(default: "general")

Request Body

{
  "feedback": "example"
}

Quick Start

Shell

curl -X POST "https://context.gnist.ai/rest/historical-events/get_historical_event" \
  -H "Content-Type: application/json" \
  -H "Gnist-API-Key: YOUR_API_KEY" \
  -d '{"event_id": "example"}'

Python

import httpx

resp = httpx.post(
    "https://context.gnist.ai/rest/historical-events/get_historical_event",
    headers={"Gnist-API-Key": "YOUR_API_KEY"},
    json={
  "event_id": "example"
},
)
print(resp.json())