Properties
| Name | Type | Description |
|---|---|---|
| id | string | |
| object | string | |
| mode | string | |
| queries | array | |
| found | boolean | |
| total | integer | |
| results | array | |
| groups | object | With several queries: the breakdown for each one. |
| near_misses | array | If nothing was found: the closest matches. |
| rejected | array | The headline looked relevant, but reading the article ruled it out. |
| diffusion | object | |
| tone | object | |
| essential | object | |
| reference | object | |
| custom_index | object | With `index`: the custom index that was searched. |
| temporal | object | How the date in the query was read: the topic was judged without it, and the results from that day go first. Null when the query names none. |
| site | stringnull | |
| index | object | |
| usage | object | |
| budget | object | |
| discovery | object | Discovery: when the index has fewer than 3 good matches, typesearch looks for sources beyond it and reads them at the original site. Null only in partial events, while it is still running. |
| incomplete | boolean | The token cap (max_tokens) or the discovery time budget ran out: there may be more. |
| cached_at | stringnull | |
| warnings | array |
JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://artifacts.apis.io/typesearch-ai/json-schema/typesearch-ai-search-response-schema.json",
"title": "SearchResponse",
"x-generated": "2026-10-31",
"x-method": "derived",
"x-generator": "derive-json-schema.py",
"x-source": "openapi/typesearch-ai-api-v1-openapi.json#/components/schemas/SearchResponse",
"type": "object",
"properties": {
"id": {
"type": "string"
},
"object": {
"type": "string",
"enum": [
"search",
"site_search",
"similar"
]
},
"mode": {
"type": "string",
"enum": [
"ultra",
"fast",
"normal",
"deep"
]
},
"queries": {
"type": "array",
"items": {
"type": "string"
}
},
"found": {
"type": "boolean"
},
"total": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"results": {
"type": "array",
"items": {
"type": "object",
"properties": {
"url": {
"type": "string"
},
"title": {
"type": "string"
},
"source": {
"type": [
"string",
"null"
]
},
"country": {
"description": "Country of the source (ISO 3166-1 alpha-2), when known.",
"type": [
"string",
"null"
]
},
"language": {
"description": "Language of the source (ISO 639-1), when known: for a source in several languages, the one asked for in `languages`, or its main one.",
"type": [
"string",
"null"
]
},
"published_at": {
"type": [
"string",
"null"
]
},
"section": {
"type": [
"string",
"null"
]
},
"snippet": {
"description": "The standfirst or description, as the outlet published it.",
"type": [
"string",
"null"
]
},
"score": {
"type": "number",
"description": "Probability that the article is about the query: from reading it if it was read, otherwise from its headline."
},
"headline_relevance": {
"type": "number"
},
"read": {
"anyOf": [
{
"type": "object",
"properties": {
"probability": {
"type": "number"
},
"centrality": {
"type": "number",
"description": "0 not mentioned · 3 main topic."
}
},
"required": [
"probability",
"centrality"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"highlights": {
"type": "array",
"items": {
"type": "string"
}
},
"tone": {
"anyOf": [
{
"type": "object",
"properties": {
"label": {
"type": "string",
"enum": [
"positive",
"neutral",
"negative"
]
},
"probabilities": {
"type": "object",
"propertyNames": {
"type": "string",
"enum": [
"positive",
"neutral",
"negative"
]
},
"additionalProperties": {
"type": "number"
},
"required": [
"positive",
"neutral",
"negative"
]
},
"basis": {
"type": "string",
"enum": [
"article",
"headline"
]
}
},
"required": [
"label",
"probabilities",
"basis"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"answers": {
"anyOf": [
{
"type": "object",
"properties": {
"basis": {
"type": "string",
"enum": [
"article",
"headline"
]
},
"values": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"anyOf": [
{
"type": "object",
"properties": {
"type": {
"type": "string",
"const": "boolean"
},
"probability": {
"type": "number"
}
},
"required": [
"type",
"probability"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"type": {
"type": "string",
"const": "choice"
},
"choice": {
"type": "string"
},
"probabilities": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"type": "number"
}
},
"confidence": {
"type": "number"
}
},
"required": [
"type",
"choice"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"type": {
"type": "string",
"const": "score"
},
"score": {
"type": "number"
},
"probabilities": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"type": "number"
}
},
"confidence": {
"type": "number"
}
},
"required": [
"type",
"score"
],
"additionalProperties": false
}
]
}
}
},
"required": [
"basis",
"values"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"duplicates": {
"type": "array",
"items": {
"type": "object",
"properties": {
"url": {
"type": "string"
},
"title": {
"type": "string"
},
"source": {
"type": [
"string",
"null"
]
}
},
"required": [
"url",
"title",
"source"
],
"additionalProperties": false
}
},
"date_match": {
"anyOf": [
{
"type": "string",
"enum": [
"exact",
"adjacent",
"unknown",
"outside"
]
},
{
"type": "null"
}
],
"description": "When the query names a date: whether the article is about that day (exact), the day before or after (adjacent), cannot tell (unknown) or another date (outside). Null otherwise."
},
"referenced_date": {
"description": "When the query names a date: the day the article is about (YYYY-MM-DD, in the request time zone), from its headline, its publication date or reading it.",
"type": [
"string",
"null"
]
},
"found_in": {
"type": "string",
"enum": [
"index",
"homepage",
"section",
"site_search",
"discovery",
"custom_index"
],
"description": "Where it was found: the index; a live site (homepage, section, site_search); discovery, a source beyond the index read at the original site for this request; or custom_index, your own index (`index`)."
},
"data": {
"description": "Custom index: the structured data the page declares about itself (schema.org and Open Graph): price, high_price, currency, availability, brand, sku, gtin, rating, reviews. Null if it declares none.",
"anyOf": [
{
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"type": [
"string",
"number"
]
}
},
{
"type": "null"
}
]
},
"queries": {
"description": "With several queries: which ones this result belongs to.",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"url",
"title",
"source",
"country",
"language",
"published_at",
"section",
"snippet",
"score",
"headline_relevance",
"read",
"highlights",
"tone",
"answers",
"duplicates",
"date_match",
"referenced_date",
"found_in"
],
"additionalProperties": false
}
},
"groups": {
"anyOf": [
{
"type": "array",
"items": {
"type": "object",
"properties": {
"query": {
"type": "string"
},
"found": {
"type": "boolean"
},
"total": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"results": {
"type": "array",
"items": {
"type": "object",
"properties": {
"url": {
"type": "string"
},
"title": {
"type": "string"
},
"source": {
"type": [
"string",
"null"
]
},
"country": {
"description": "Country of the source (ISO 3166-1 alpha-2), when known.",
"type": [
"string",
"null"
]
},
"language": {
"description": "Language of the source (ISO 639-1), when known: for a source in several languages, the one asked for in `languages`, or its main one.",
"type": [
"string",
"null"
]
},
"published_at": {
"type": [
"string",
"null"
]
},
"section": {
"type": [
"string",
"null"
]
},
"snippet": {
"description": "The standfirst or description, as the outlet published it.",
"type": [
"string",
"null"
]
},
"score": {
"type": "number",
"description": "Probability that the article is about the query: from reading it if it was read, otherwise from its headline."
},
"headline_relevance": {
"type": "number"
},
"read": {
"anyOf": [
{
"type": "object",
"properties": {
"probability": {
"type": "number"
},
"centrality": {
"type": "number",
"description": "0 not mentioned · 3 main topic."
}
},
"required": [
"probability",
"centrality"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"highlights": {
"type": "array",
"items": {
"type": "string"
}
},
"tone": {
"anyOf": [
{
"type": "object",
"properties": {
"label": {
"type": "string",
"enum": [
"positive",
"neutral",
"negative"
]
},
"probabilities": {
"type": "object",
"propertyNames": {
"type": "string",
"enum": [
"positive",
"neutral",
"negative"
]
},
"additionalProperties": {
"type": "number"
},
"required": [
"positive",
"neutral",
"negative"
]
},
"basis": {
"type": "string",
"enum": [
"article",
"headline"
]
}
},
"required": [
"label",
"probabilities",
"basis"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"answers": {
"anyOf": [
{
"type": "object",
"properties": {
"basis": {
"type": "string",
"enum": [
"article",
"headline"
]
},
"values": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"anyOf": [
{
"type": "object",
"properties": {
"type": {
"type": "string",
"const": "boolean"
},
"probability": {
"type": "number"
}
},
"required": [
"type",
"probability"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"type": {
"type": "string",
"const": "choice"
},
"choice": {
"type": "string"
},
"probabilities": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"type": "number"
}
},
"confidence": {
"type": "number"
}
},
"required": [
"type",
"choice"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"type": {
"type": "string",
"const": "score"
},
"score": {
"type": "number"
},
"probabilities": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"type": "number"
}
},
"confidence": {
"type": "number"
}
},
"required": [
"type",
"score"
],
"additionalProperties": false
}
]
}
}
},
"required": [
"basis",
"values"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"duplicates": {
"type": "array",
"items": {
"type": "object",
"properties": {
"url": {
"type": "string"
},
"title": {
"type": "string"
},
"source": {
"type": [
"string",
"null"
]
}
},
"required": [
"url",
"title",
"source"
],
"additionalProperties": false
}
},
"date_match": {
"anyOf": [
{
"type": "string",
"enum": [
"exact",
"adjacent",
"unknown",
"outside"
]
},
{
"type": "null"
}
],
"description": "When the query names a date: whether the article is about that day (exact), the day before or after (adjacent), cannot tell (unknown) or another date (outside). Null otherwise."
},
"referenced_date": {
"description": "When the query names a date: the day the article is about (YYYY-MM-DD, in the request time zone), from its headline, its publication date or reading it.",
"type": [
"string",
"null"
]
},
"found_in": {
"type": "string",
"enum": [
"index",
"homepage",
"section",
"site_search",
"discovery",
"custom_index"
],
"description": "Where it was found: the index; a live site (homepage, section, site_search); discovery, a source beyond the index read at the original site for this request; or custom_index, your own index (`index`)."
},
"data": {
"description": "Custom index: the structured data the page declares about itself (schema.org and Open Graph): price, high_price, currency, availability, brand, sku, gtin, rating, reviews. Null if it declares none.",
"anyOf": [
{
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"type": [
"string",
"number"
]
}
},
{
"type": "null"
}
]
},
"queries": {
"description": "With several queries: which ones this result belongs to.",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"url",
"title",
"source",
"country",
"language",
"published_at",
"section",
"snippet",
"score",
"headline_relevance",
"read",
"highlights",
"tone",
"answers",
"duplicates",
"date_match",
"referenced_date",
"found_in"
],
"additionalProperties": false
}
},
"near_misses": {
"type": "array",
"items": {
"type": "object",
"properties": {
"url": {
"type": "string"
},
"title": {
"type": "string"
},
"source": {
"type": [
"string",
"null"
]
},
"country": {
"description": "Country of the source (ISO 3166-1 alpha-2), when known.",
"type": [
"string",
"null"
]
},
"language": {
"description": "Language of the source (ISO 639-1), when known: for a source in several languages, the one asked for in `languages`, or its main one.",
"type": [
"string",
"null"
]
},
"published_at": {
"type": [
"string",
"null"
]
},
"section": {
"type": [
"string",
"null"
]
},
"snippet": {
"description": "The standfirst or description, as the outlet published it.",
"type": [
"string",
"null"
]
},
"score": {
"type": "number",
"description": "Probability that the article is about the query: from reading it if it was read, otherwise from its headline."
},
"headline_relevance": {
"type": "number"
},
"read": {
"anyOf": [
{
"type": "object",
"properties": {
"probability": {
"type": "number"
},
"centrality": {
"type": "number",
"description": "0 not mentioned · 3 main topic."
}
},
"required": [
"probability",
"centrality"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"highlights": {
"type": "array",
"items": {
"type": "string"
}
},
"tone": {
"anyOf": [
{
"type": "object",
"properties": {
"label": {
"type": "string",
"enum": [
"positive",
"neutral",
"negative"
]
},
"probabilities": {
"type": "object",
"propertyNames": {
"type": "string",
"enum": [
"positive",
"neutral",
"negative"
]
},
"additionalProperties": {
"type": "number"
},
"required": [
"positive",
"neutral",
"negative"
]
},
"basis": {
"type": "string",
"enum": [
"article",
"headline"
]
}
},
"required": [
"label",
"probabilities",
"basis"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"answers": {
"an
# --- truncated at 32 KB (105 KB total) ---
# Full source: https://artifacts.apis.io/typesearch-ai/json-schema/typesearch-ai-search-response-schema.json
Work with this as data
Every JSON Schema 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 schemas
4 MCP tools reach this
find_json_schemasBrowse and filter every JSON Schema 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.
Call it yourself
curl for this page
This JSON Schema
curl "https://apis.io/api/v1/json-schemas/typesearch-ai-search-response"
All schemas
curl "https://apis.io/api/v1/json-schemas?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.
A second provider on the same verified email joins the account you already have.