Tools (6)

get_historical_figure
search_historical_figures
list_figures_by_field
list_figures_by_era
list_figures_by_nationality
report_feedback

get_historical_figure

Get detailed information about a historical figure by ID.

Returns biographical data including birth/death years, nationality, field, era, and description.

Parameter	Type	Required	Description
`figure_id`	`string`	required	Slug ID of the historical figure (e.g. 'julius-caesar', 'albert-einstein').

Request Body

{
  "figure_id": "example"
}

search_historical_figures

Search historical figures by keyword.

Searches across names, achievements, and descriptions. Case-insensitive.

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

Request Body

{
  "query": "example"
}

list_figures_by_field

List historical figures by their field of achievement.

Valid fields include: Politics & Leadership, Science & Mathematics, Arts & Literature,
Philosophy, Military, Exploration, Religion, Activism, Business & Economics.

Parameter	Type	Required	Description
`field`	`string`	required	Field of achievement (e.g. 'Science & Mathematics', 'Arts & Literature', 'Philosophy').
`limit`	`any`	optional	Maximum number of results (default: 50, max: 100).

Request Body

{
  "field": "example"
}

list_figures_by_era

List historical figures by historical era.

Valid eras: Ancient, Medieval, Renaissance, Early Modern, Modern, Contemporary.

Parameter	Type	Required	Description
`era`	`string`	required	Historical era (e.g. 'Ancient', 'Medieval', 'Renaissance', 'Modern', 'Contemporary').
`limit`	`any`	optional	Maximum number of results (default: 50, max: 100).

Request Body

{
  "era": "example"
}

list_figures_by_nationality

List historical figures by nationality.

Partial matching — e.g. 'american' matches 'American', 'Serbian-American', etc.

Parameter	Type	Required	Description
`nationality`	`string`	required	Nationality to filter by (case-insensitive, partial match).
`limit`	`any`	optional	Maximum number of results (default: 50, max: 100).

Request Body

{
  "nationality": "example"
}

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-figures/get_historical_figure" \
  -H "Content-Type: application/json" \
  -H "Gnist-API-Key: YOUR_API_KEY" \
  -d '{"figure_id": "example"}'

Python

import httpx

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