change_historyread-only | How AiSeek's evidence record for one published change developed, and what AiSeek knew about it earlier. Always returns the change's receipts per claim, newest first (each names its parent receipt, so the revision chain reads from the list), and the change as first published when the plan's window reaches that date. With `known_at` it also returns the change as known at that moment: whether readers could see it then, whether its headline changed later, and each claim's newest receipt written by then. History starts the day SeekTrace began; before it a result says precision EXISTENCE_ONLY (whether a record existed, never what it said). Old headline text is not kept, so `current` is today's version. A receipt records an assessment; it is not a certificate that a claim is true. Use it for what-did-we-know-then questions and to find receipt ids for get_receipt; use get_change for today's view and sources. Read-only; one call of the key's quota. |
companyread-only | Look up a company on AiSeek, in one of two modes. With `slug` (the exact company slug, e.g. toyota) it returns the profile: name, country, listings, description, recent published changes, stated claims and relations. With only `query` (a name, alias or ticker) it returns {items}: up to 10 matching companies, most active first, each with its slug; call company again with a slug for the profile. `slug` wins when both are given. Do not use it to find news about a company (search_changes with its name) or for filings, which are not included. An unknown slug is an error. Read-only; one call of the key's quota. |
country_heatread-only | SeekEarth's Change Heat per country: how much verified change AiSeek recorded in each country, against that country's own recent normal. Heat runs 0 to 100 and measures the amount of change, never danger or instability: 50 is an ordinary day for the country, 75 a day twice as busy. Each country also has its delta, number of changes, domains, a convergence flag and a seven-day series. Use it to see where things are changing, across countries or for one. Do not use it for the changes themselves (search_changes) or for one place at one moment with its Earth layers (earth_at). Changes with no single country are not counted. Read-only; one call of the key's quota. |
earth_atread-only | SeekEarth for one place and one moment: what was happening there, from AiSeek's published changes and the Earth's layers (disaster alerts, cyclones, official weather warnings, conflict, outbreaks, power plants and more). Give a place, either `country` or `lat` and `lon`, and optionally a moment `at` and a window of `days`. NOW (the default) reads today's knowledge of those days; KNOWN reads what readers could see at `at`, and changes withdrawn since are only counted. Returns the place, its changes (at most 30, each with url), the Change Heat of its countries and the layer items in force there, each with its nature (OFFICIAL, AUTOMATIC, FORECAST, OBSERVED) and the source to credit. Use it for where-and-when questions. Do not use it for heat across all countries (country_heat), changes by topic (search_changes) or one change's evidence over time (change_history). Read-only; one call of the key's quota. |
get_changeread-only | Get one published change with its sources: headline, summary, scores (importance, novelty, velocity, evidence strength), main subject and, for each outlet that reported it, the name, link, date, evidence level and role. Use it after latest_changes or search_changes, to see who reported a change. Quoted passages are never returned, only names and links: open a source link or the AiSeek page (url) to read them. Not for evidence receipts or what AiSeek knew earlier: use change_history. The result's dossierId, when set, names an in-depth dossier that no tool returns; read it at https://aiseek.dev/{locale}/stories/{dossierId}. An unknown or unpublished id is an error. Read-only; one call of the key's quota. |
get_receiptread-only | Get one SeekTrace evidence receipt: the immutable record of how AiSeek assessed one claim and on what evidence. It carries the claim class (FACT, SUPPORTED or HYPOTHESIS), assessment status, currency status, valid time, the evidence list (ids, source links, level, stance and content digests, never quoted text), independence counts, the parent receipt it revised and the sha256 digest of its payload. A receipt records an assessment; it is not a certificate that a claim is true. Use it to read what a receipt says; to check that the stored record is unchanged use verify_receipt. Receipt ids come from change_history (receipts[].id). Only public receipts can be read, on every plan; links to sources whose text may not be shown are withheld (redactedEvidence counts them). Read-only; one call of the key's quota. |
latest_briefread-only | The latest brief: AiSeek's own summary of a period's changes, grouped by section, each item linking to its page. DAILY (the default) covers one UTC day; WEEKLY also carries the week's largest market moves and the events of the coming week. Use it for a digest. Do not use it for the raw newest-first list (latest_changes) or a topic (search_changes). On a Free key a brief opens one day after publication: a younger one returns only title and summary with locked true and unlocksAt. An error if none has been published yet. Read-only; one call of the key's quota. |
latest_changesread-only | List the newest published changes on AiSeek (verified changes in the world: economy, markets, policy, technology, companies, science), newest first, 20 per page. Use it to see what is new or to browse without a topic. Do not use it to look for a topic, company or country: use search_changes. For a digest of a period use latest_brief. Each item carries the change id (pass it to get_change or change_history) and the url of its AiSeek page. Read-only; one call of the key's quota. |
recent_correctionsread-only | Public corrections about published content, newest first: changes taken down, and changes or dossiers still published whose evidence was corrected and is under review or was resolved in the last 30 days. Each item has an id, kind, time, reason category, state (UNDER_REVIEW or RESOLVED), the target id while it is public and a title where one may be shown. A correction flags what depends on the corrected evidence for review; nothing is withdrawn automatically. Use it to check whether something you read earlier was corrected, or to audit AiSeek's error record. Do not use it to read one change's evidence history (change_history) or to browse new changes (latest_changes). Read-only; one call of the key's quota. |
release_calendarread-only | Scheduled releases and decisions in a time range: central-bank decisions, statistics releases, earnings, rule effective dates, comment deadlines, trade measures, filings, meetings, votes and product launches. Use it for what is coming (or just passed). Do not use it for what has already happened: use latest_changes. Each event has its time (UTC), precision, status, source link, region and importance; tracked releases give the previous reading and, once out, the new one, never a forecast, and policy-rate figures are left out. Read-only; one call of the key's quota. |
search_changesread-only | Search published changes by words (a company, a country, a subject, a name) in English, Chinese or Japanese; results are ranked by relevance, best first, not by time. Use it to find changes about something. Do not use it to browse what is newest (use latest_changes) or to look up a company's profile (use company). Each result carries the change id (pass it to get_change for the sources) and its url. Read-only; one call of the key's quota. |
verify_receiptread-only | Recompute a receipt's digest from the stored record and report whether it still matches: ok, digestMatches, canonicalForm, columnsMatch, evidenceRowsMatch and a list of problems (DIGEST_MISMATCH, NOT_CANONICAL, COLUMN_MISMATCH:<field>, EVIDENCE_ROWS_MISMATCH, PAYLOAD_UNREADABLE). ok true means the stored record is unchanged since it was written. A receipt records an assessment; it is not a certificate that a claim is true. Use it before you cite a receipt, after get_receipt has shown you what it says; it does not return the receipt's content. The id comes from change_history (receipts[].id). Public receipts only; an unknown or non-public id is an error. Read-only; one call of the key's quota. |