DeepSearch

Build dossier

build_dossier

Read-only

Assemble one person's entire public footprint into a single sourced profile: identity, contact details, social accounts unified across platforms, work history, education, relatives, locations, and web mentions - every claim linked to the page it came from. Prefer this over reading search results yourself when you need the whole picture of one person rather than a single fact; it does the cross-platform correlation that a web search leaves to you. Pass a name plus the headline or username from search_people so the right individual is profiled. Repeating the same request from the same account replays its cached profile: free and instant. Profiles are not shared between accounts. Public sources only - never private accounts or breach data. Requires dossier scope. Provider work consumes account usage; cached results consume none.

Input Schema

TableJSON Schema

Name	Required	Description
`name`	Yes
`refresh`	No
`sandbox`	No
`headline`	No
`username`	No
`idempotency_key`	No	Reuse this key when retrying the same inputs.

Output Schema

TableJSON Schema

Name	Required	Description	Default
`usage`	Yes
`cached`	Yes
`events`	Yes
`object`	Yes
`status`	No
`dossier`	Yes
`warning`	No
`metadata`	Yes
`request_id`	Yes

Schema Changelog

Changes observed during successful MCP inspections.

Changed2 schema fields changedOct 9, 2026

addedOutput schema / properties / dossier / properties / sections / properties / identity / properties / linkedProfileUrls

Added value: +{
+  "items": {
+    "format": "uri",
+    "type": "string"
+  },
+  "maxItems": 32,
+  "type": "array"
+}

changedOutput schema / properties / events / items / anyOf

Previous value: -[
-  {
-    "additionalProperties": true,
-    "properties": {
-      "hit": {
-        "anyOf": [
-          {
-            "additionalProperties": {},
-            "properties": {
-              "age": {
-                "exclusiveMinimum": 0,
-                "maximum": 9007199254740991,
-                "type": "integer"
-              },
-              "avatarCandidates": {
-                "items": {
-                  "format": "uri",
-                  "type": "string"
-                },
-                "maxItems": 10,
-                "type": "array"
-              },
-              "avatarContext": {
-                "enum": [
-                  "account",
-                  "authority",
-                  "submitted",
-                  "subject"
-                ],
-                "type": "string"
-              },
-              "avatarUrl": {
-                "format": "uri",
-                "type": "string"
-              },
-              "confidence": {
-                "type": "number"
-              },
-              "headline": {
-                "maxLength": 500,
-                "type": "string"
-              },
-              "id": {
-                "type": "string"
-              },
-              "identityContext": {
-                "enum": [
-                  "account",
-                  "authority",
-                  "submitted"
-                ],
-                "type": "string"
-              },
-              "initials": {
-                "type": "string"
-              },
-              "kind": {
-                "const": "person",
-                "type": "string"
-              },
-              "location": {
-                "maxLength": 500,
-                "type": "string"
-              },
-              "name": {
-                "maxLength": 180,
-                "minLength": 1,
-                "type": "string"
-              },
-              "primaryPlatform": {
-                "enum": [
-                  "instagram",
-                  "facebook",
-                  "x",
-                  "twitter",
-                  "tiktok",
-                  "linkedin",
-                  "youtube",
-                  "whatsapp",
-                  "telegram",
-                  "snapchat",
-                  "reddit",
-                  "threads",
-                  "bluesky",
-                  "mastodon",
-                  "pinterest",
-                  "twitch",
-                  "discord",
-                  "tinder",
-                  "bumble",
-                  "hinge",
-                  "onlyfans",
-                  "fansly",
-                  "patreon",
-                  "cameo",
-                  "vsco",
-                  "tumblr",
-                  "flickr",
-                  "strava",
-                  "apple_music",
-                  "bandcamp",
-                  "lastfm",
-                  "vimeo",
-                  "letterboxd",
-                  "goodreads",
-                  "quora",
-                  "github",
-                  "stack_overflow",
-                  "hacker_news",
-                  "npm",
-                  "kaggle",
-                  "medium",
-                  "substack",
-                  "product_hunt",
-                  "wellfound",
-                  "crunchbase",
-                  "behance",
-                  "dribbble",
-                  "soundcloud",
-                  "spotify",
-                  "orcid",
-                  "google_scholar",
-                  "researchgate",
-                  "academia",
-                  "linktree",
-                  "personal_website",
-                  "company_page",
-                  "other"
-                ],
-                "type": "string"
-              },
-              "primaryUrl": {
-                "format": "uri",
-                "type": "string"
-              },
-              "primaryUsername": {
-                "maxLength": 80,
-                "type": "string"
-              },
-              "seedEmail": {
-                "maxLength": 320,
-                "type": "string"
-              },
-              "seedPhone": {
-                "maxLength": 80,
-                "type": "string"
-              },
-              "tags": {
-                "items": {
-                  "type": "string"
-                },
-                "type": "array"
-              }
-            },
-            "required": [
-              "id",
-              "name",
-              "initials",
-              "confidence",
-              "tags"
-            ],
-            "type": "object"
-          },
-          {
-            "additionalProperties": {},
-            "properties": {
-              "confidence": {
-                "type": "number"
-              },
-              "domain": {
-                "maxLength": 255,
-                "type": "string"
-              },
-              "headline": {
-                "maxLength": 500,
-                "type": "string"
-              },
-              "id": {
-                "type": "string"
-              },
-              "initials": {
-                "type": "string"
-              },
-              "jurisdiction": {
-                "maxLength": 120,
-                "type": "string"
-              },
-              "kind": {
-                "const": "company",
-                "type": "string"
-              },
-              "legalName": {
-                "maxLength": 180,
-                "type": "string"
-              },
-              "logoUrl": {
-                "format": "uri",
-                "type": "string"
-              },
-              "name": {
-                "maxLength": 180,
-                "minLength": 1,
-                "type": "string"
-              },
-              "seedDomain": {
-                "maxLength": 255,
-                "type": "string"
-              },
-              "seedRegistryId": {
-                "maxLength": 120,
-                "type": "string"
-              },
-              "seedRegistrySource": {
-                "maxLength": 80,
-                "type": "string"
-              },
-              "status": {
-                "enum": [
-                  "active",
-                  "dissolved",
-                  "unknown"
-                ],
-                "type": "string"
-              },
-              "tags": {
-                "items": {
-                  "type": "string"
-                },
-                "type": "array"
-              }
-            },
-            "required": [
-              "id",
-              "name",
-              "initials",
-              "confidence",
-              "tags",
-              "kind"
-            ],
-            "type": "object"
-          }
-        ]
-      },
-      "type": {
-        "const": "hit",
-        "type": "string"
-      }
-    },
-    "required": [
-      "type",
-      "hit"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": true,
-    "properties": {
-      "delta": {
-        "type": "string"
-      },
-      "type": {
-        "const": "text",
-        "type": "string"
-      }
-    },
-    "required": [
-      "type",
-      "delta"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": true,
-    "properties": {
-      "delta": {
-        "type": "string"
-      },
-      "type": {
-        "const": "summary",
-        "type": "string"
-      }
-    },
-    "required": [
-      "type",
-      "delta"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": true,
-    "properties": {
-      "sources": {
-        "items": {
-          "additionalProperties": {},
-          "properties": {
-            "authorImageUrl": {
-              "type": "string"
-            },
-            "authorName": {
-              "type": "string"
-            },
-            "cited": {
-              "type": "boolean"
-            },
-            "domain": {
-              "type": "string"
-            },
-            "id": {
-              "type": "string"
-            },
-            "position": {
-              "type": "number"
-            },
-            "publishedAt": {
-              "type": "string"
-            },
-            "snippet": {
-              "type": "string"
-            },
-            "title": {
-              "type": "string"
-            },
-            "url": {
-              "type": "string"
-            }
-          },
-          "required": [
-            "id",
-            "position",
-            "url",
-            "title",
-            "domain"
-          ],
-          "type": "object"
-        },
-        "type": "array"
-      },
-      "type": {
-        "const": "sources",
-        "type": "string"
-      }
-    },
-    "required": [
-      "type",
-      "sources"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": true,
-    "properties": {
-      "questions": {
-        "items": {
-          "type": "string"
-        },
-        "type": "array"
-      },
-      "type": {
-        "const": "related",
-        "type": "string"
-      }
-    },
-    "required": [
-      "type",
-      "questions"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": true,
-    "properties": {
-      "data": {},
-      "key": {
-        "enum": [
-          "identity",
-          "photos",
-          "contact",
-          "socials",
-          "locations",
-          "relatives",
-          "work",
-          "education",
-          "mentions",
-          "dating",
-          "relationships"
-        ],
-        "type": "string"
-      },
-      "type": {
-        "const": "section",
-        "type": "string"
-      }
-    },
-    "required": [
-      "type",
-      "key",
-      "data"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": true,
-    "properties": {
-      "data": {},
-      "key": {
-        "enum": [
-          "identity",
-          "registration",
-          "industry",
-          "financials",
-          "funding",
-          "executives",
-          "locations",
-          "linkage",
-          "contact",
-          "mentions"
-        ],
-        "type": "string"
-      },
-      "type": {
-        "const": "entity_section",
-        "type": "string"
-      }
-    },
-    "required": [
-      "type",
-      "key",
-      "data"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": true,
-    "properties": {
-      "data": {},
-      "key": {
-        "enum": [
-          "identity",
-          "engine",
-          "safety",
-          "recalls",
-          "history"
-        ],
-        "type": "string"
-      },
-      "type": {
-        "const": "vehicle_section",
-        "type": "string"
-      }
-    },
-    "required": [
-      "type",
-      "key",
-      "data"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": true,
-    "properties": {
-      "match": {
-        "additionalProperties": {},
-        "properties": {
-          "date": {
-            "type": "string"
-          },
-          "imageUrl": {
-            "type": "string"
-          },
-          "matchKind": {
-            "type": "string"
-          },
-          "snippet": {
-            "type": "string"
-          },
-          "sourceDomain": {
-            "type": "string"
-          },
-          "thumbnailUrl": {
-            "type": "string"
-          },
-          "title": {
-            "type": "string"
-          },
-          "url": {
-            "type": "string"
-          }
-        },
-        "required": [
-          "url",
-          "sourceDomain"
-        ],
-        "type": "object"
-      },
-      "type": {
-        "const": "image_match",
-        "type": "string"
-      }
-    },
-    "required": [
-      "type",
-      "match"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": true,
-    "properties": {
-      "image": {
-        "additionalProperties": {},
-        "properties": {
-          "imageUrl": {
-            "type": "string"
-          },
-          "sourceDomain": {
-            "type": "string"
-          },
-          "sourceUrl": {
-            "type": "string"
-          },
-          "thumbnailUrl": {
-            "type": "string"
-          },
-          "title": {
-            "type": "string"
-          }
-        },
-        "required": [
-          "imageUrl"
-        ],
-        "type": "object"
-      },
-      "type": {
-        "const": "similar_image",
-        "type": "string"
-      }
-    },
-    "required": [
-      "type",
-      "image"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": true,
-    "properties": {
-      "result": {
-        "additionalProperties": {},
-        "properties": {
-          "matches": {
-            "items": {
-              "additionalProperties": {},
-              "properties": {
-                "date": {
-                  "type": "string"
-                },
-                "imageUrl": {
-                  "type": "string"
-                },
-                "matchKind": {
-                  "type": "string"
-                },
-                "snippet": {
-                  "type": "string"
-                },
-                "sourceDomain": {
-                  "type": "string"
-                },
-                "thumbnailUrl": {
-                  "type": "string"
-                },
-                "title": {
-                  "type": "string"
-                },
-                "url": {
-                  "type": "string"
-                }
-              },
-              "required": [
-                "url",
-                "sourceDomain"
-              ],
-              "type": "object"
-            },
-            "type": "array"
-          },
-          "provider": {
-            "type": "string"
-          },
-          "similar": {
-            "items": {
-              "additionalProperties": {},
-              "properties": {
-                "imageUrl": {
-                  "type": "string"
-                },
-                "sourceDomain": {
-                  "type": "string"
-                },
-                "sourceUrl": {
-                  "type": "string"
-                },
-                "thumbnailUrl": {
-                  "type": "string"
-                },
-                "title": {
-                  "type": "string"
-                }
-              },
-              "required": [
-                "imageUrl"
-              ],
-              "type": "object"
-            },
-            "type": "array"
-          }
-        },
-        "required": [
-          "provider"
-        ],
-        "type": "object"
-      },
-      "type": {
-        "const": "image_summary",
-        "type": "string"
-      }
-    },
-    "required": [
-      "type",
-      "result"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": true,
-    "properties": {
-      "type": {
-        "const": "done",
-        "type": "string"
-      }
-    },
-    "required": [
-      "type"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": true,
-    "properties": {
-      "code": {
-        "type": "string"
-      },
-      "message": {
-        "type": "string"
-      },
-      "type": {
-        "const": "error",
-        "type": "string"
-      }
-    },
-    "required": [
-      "type",
-      "message"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": {},
-    "properties": {
-      "type": {
-        "type": "string"
-      }
-    },
-    "required": [
-      "type"
-    ],
-    "type": "object"
-  }
-]New value: +[
+  {
+    "additionalProperties": true,
+    "properties": {
+      "hit": {
+        "anyOf": [
+          {
+            "additionalProperties": {},
+            "properties": {
+              "age": {
+                "exclusiveMinimum": 0,
+                "maximum": 9007199254740991,
+                "type": "integer"
+              },
+              "avatarCandidates": {
+                "items": {
+                  "format": "uri",
+                  "type": "string"
+                },
+                "maxItems": 10,
+                "type": "array"
+              },
+              "avatarContext": {
+                "enum": [
+                  "account",
+                  "authority",
+                  "submitted",
+                  "subject"
+                ],
+                "type": "string"
+              },
+              "avatarUrl": {
+                "format": "uri",
+                "type": "string"
+              },
+              "confidence": {
+                "type": "number"
+              },
+              "headline": {
+                "maxLength": 500,
+                "type": "string"
+              },
+              "id": {
+                "type": "string"
+              },
+              "identityContext": {
+                "enum": [
+                  "account",
+                  "authority",
+                  "submitted"
+                ],
+                "type": "string"
+              },
+              "initials": {
+                "type": "string"
+              },
+              "kind": {
+                "const": "person",
+                "type": "string"
+              },
+              "linkedProfileUrls": {
+                "items": {
+                  "format": "uri",
+                  "type": "string"
+                },
+                "maxItems": 32,
+                "type": "array"
+              },
+              "location": {
+                "maxLength": 500,
+                "type": "string"
+              },
+              "name": {
+                "maxLength": 180,
+                "minLength": 1,
+                "type": "string"
+              },
+              "primaryPlatform": {
+                "enum": [
+                  "instagram",
+                  "facebook",
+                  "x",
+                  "twitter",
+                  "tiktok",
+                  "linkedin",
+                  "youtube",
+                  "whatsapp",
+                  "telegram",
+                  "snapchat",
+                  "reddit",
+                  "threads",
+                  "bluesky",
+                  "mastodon",
+                  "pinterest",
+                  "twitch",
+                  "discord",
+                  "tinder",
+                  "bumble",
+                  "hinge",
+                  "onlyfans",
+                  "fansly",
+                  "patreon",
+                  "cameo",
+                  "vsco",
+                  "tumblr",
+                  "flickr",
+                  "strava",
+                  "apple_music",
+                  "bandcamp",
+                  "lastfm",
+                  "vimeo",
+                  "letterboxd",
+                  "goodreads",
+                  "quora",
+                  "github",
+                  "stack_overflow",
+                  "hacker_news",
+                  "npm",
+                  "kaggle",
+                  "medium",
+                  "substack",
+                  "product_hunt",
+                  "wellfound",
+                  "crunchbase",
+                  "behance",
+                  "dribbble",
+                  "soundcloud",
+                  "spotify",
+                  "orcid",
+                  "google_scholar",
+                  "researchgate",
+                  "academia",
+                  "linktree",
+                  "personal_website",
+                  "company_page",
+                  "other"
+                ],
+                "type": "string"
+              },
+              "primaryUrl": {
+                "format": "uri",
+                "type": "string"
+              },
+              "primaryUsername": {
+                "maxLength": 80,
+                "type": "string"
+              },
+              "seedEmail": {
+                "maxLength": 320,
+                "type": "string"
+              },
+              "seedPhone": {
+                "maxLength": 80,
+                "type": "string"
+              },
+              "tags": {
+                "items": {
+                  "type": "string"
+                },
+                "type": "array"
+              }
+            },
+            "required": [
+              "id",
+              "name",
+              "initials",
+              "confidence",
+              "tags"
+            ],
+            "type": "object"
+          },
+          {
+            "additionalProperties": {},
+            "properties": {
+              "confidence": {
+                "type": "number"
+              },
+              "domain": {
+                "maxLength": 255,
+                "type": "string"
+              },
+              "headline": {
+                "maxLength": 500,
+                "type": "string"
+              },
+              "id": {
+                "type": "string"
+              },
+              "initials": {
+                "type": "string"
+              },
+              "jurisdiction": {
+                "maxLength": 120,
+                "type": "string"
+              },
+              "kind": {
+                "const": "company",
+                "type": "string"
+              },
+              "legalName": {
+                "maxLength": 180,
+                "type": "string"
+              },
+              "logoUrl": {
+                "format": "uri",
+                "type": "string"
+              },
+              "name": {
+                "maxLength": 180,
+                "minLength": 1,
+                "type": "string"
+              },
+              "seedDomain": {
+                "maxLength": 255,
+                "type": "string"
+              },
+              "seedRegistryId": {
+                "maxLength": 120,
+                "type": "string"
+              },
+              "seedRegistrySource": {
+                "maxLength": 80,
+                "type": "string"
+              },
+              "status": {
+                "enum": [
+                  "active",
+                  "dissolved",
+                  "unknown"
+                ],
+                "type": "string"
+              },
+              "tags": {
+                "items": {
+                  "type": "string"
+                },
+                "type": "array"
+              }
+            },
+            "required": [
+              "id",
+              "name",
+              "initials",
+              "confidence",
+              "tags",
+              "kind"
+            ],
+            "type": "object"
+          }
+        ]
+      },
+      "type": {
+        "const": "hit",
+        "type": "string"
+      }
+    },
+    "required": [
+      "type",
+      "hit"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": true,
+    "properties": {
+      "delta": {
+        "type": "string"
+      },
+      "type": {
+        "const": "text",
+        "type": "string"
+      }
+    },
+    "required": [
+      "type",
+      "delta"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": true,
+    "properties": {
+      "delta": {
+        "type": "string"
+      },
+      "type": {
+        "const": "summary",
+        "type": "string"
+      }
+    },
+    "required": [
+      "type",
+      "delta"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": true,
+    "properties": {
+      "sources": {
+        "items": {
+          "additionalProperties": {},
+          "properties": {
+            "authorImageUrl": {
+              "type": "string"
+            },
+            "authorName": {
+              "type": "string"
+            },
+            "cited": {
+              "type": "boolean"
+            },
+            "domain": {
+              "type": "string"
+            },
+            "id": {
+              "type": "string"
+            },
+            "position": {
+              "type": "number"
+            },
+            "publishedAt": {
+              "type": "string"
+            },
+            "snippet": {
+              "type": "string"
+            },
+            "title": {
+              "type": "string"
+            },
+            "url": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "id",
+            "position",
+            "url",
+            "title",
+            "domain"
+          ],
+          "type": "object"
+        },
+        "type": "array"
+      },
+      "type": {
+        "const": "sources",
+        "type": "string"
+      }
+    },
+    "required": [
+      "type",
+      "sources"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": true,
+    "properties": {
+      "questions": {
+        "items": {
+          "type": "string"
+        },
+        "type": "array"
+      },
+      "type": {
+        "const": "related",
+        "type": "string"
+      }
+    },
+    "required": [
+      "type",
+      "questions"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": true,
+    "properties": {
+      "data": {},
+      "key": {
+        "enum": [
+          "identity",
+          "photos",
+          "contact",
+          "socials",
+          "locations",
+          "relatives",
+          "work",
+          "education",
+          "mentions",
+          "dating",
+          "relationships"
+        ],
+        "type": "string"
+      },
+      "type": {
+        "const": "section",
+        "type": "string"
+      }
+    },
+    "required": [
+      "type",
+      "key",
+      "data"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": true,
+    "properties": {
+      "data": {},
+      "key": {
+        "enum": [
+          "identity",
+          "registration",
+          "industry",
+          "financials",
+          "funding",
+          "executives",
+          "locations",
+          "linkage",
+          "contact",
+          "mentions"
+        ],
+        "type": "string"
+      },
+      "type": {
+        "const": "entity_section",
+        "type": "string"
+      }
+    },
+    "required": [
+      "type",
+      "key",
+      "data"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": true,
+    "properties": {
+      "data": {},
+      "key": {
+        "enum": [
+          "identity",
+          "engine",
+          "safety",
+          "recalls",
+          "history"
+        ],
+        "type": "string"
+      },
+      "type": {
+        "const": "vehicle_section",
+        "type": "string"
+      }
+    },
+    "required": [
+      "type",
+      "key",
+      "data"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": true,
+    "properties": {
+      "match": {
+        "additionalProperties": {},
+        "properties": {
+          "date": {
+            "type": "string"
+          },
+          "imageUrl": {
+            "type": "string"
+          },
+          "matchKind": {
+            "type": "string"
+          },
+          "snippet": {
+            "type": "string"
+          },
+          "sourceDomain": {
+            "type": "string"
+          },
+          "thumbnailUrl": {
+            "type": "string"
+          },
+          "title": {
+            "type": "string"
+          },
+          "url": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "url",
+          "sourceDomain"
+        ],
+        "type": "object"
+      },
+      "type": {
+        "const": "image_match",
+        "type": "string"
+      }
+    },
+    "required": [
+      "type",
+      "match"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": true,
+    "properties": {
+      "image": {
+        "additionalProperties": {},
+        "properties": {
+          "imageUrl": {
+            "type": "string"
+          },
+          "sourceDomain": {
+            "type": "string"
+          },
+          "sourceUrl": {
+            "type": "string"
+          },
+          "thumbnailUrl": {
+            "type": "string"
+          },
+          "title": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "imageUrl"
+        ],
+        "type": "object"
+      },
+      "type": {
+        "const": "similar_image",
+        "type": "string"
+      }
+    },
+    "required": [
+      "type",
+      "image"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": true,
+    "properties": {
+      "result": {
+        "additionalProperties": {},
+        "properties": {
+          "matches": {
+            "items": {
+              "additionalProperties": {},
+              "properties": {
+                "date": {
+                  "type": "string"
+                },
+                "imageUrl": {
+                  "type": "string"
+                },
+                "matchKind": {
+                  "type": "string"
+                },
+                "snippet": {
+                  "type": "string"
+                },
+                "sourceDomain": {
+                  "type": "string"
+                },
+                "thumbnailUrl": {
+                  "type": "string"
+                },
+                "title": {
+                  "type": "string"
+                },
+                "url": {
+                  "type": "string"
+                }
+              },
+              "required": [
+                "url",
+                "sourceDomain"
+              ],
+              "type": "object"
+            },
+            "type": "array"
+          },
+          "provider": {
+            "type": "string"
+          },
+          "similar": {
+            "items": {
+              "additionalProperties": {},
+              "properties": {
+                "imageUrl": {
+                  "type": "string"
+                },
+                "sourceDomain": {
+                  "type": "string"
+                },
+                "sourceUrl": {
+                  "type": "string"
+                },
+                "thumbnailUrl": {
+                  "type": "string"
+                },
+                "title": {
+                  "type": "string"
+                }
+              },
+              "required": [
+                "imageUrl"
+              ],
+              "type": "object"
+            },
+            "type": "array"
+          }
+        },
+        "required": [
+          "provider"
+        ],
+        "type": "object"
+      },
+      "type": {
+        "const": "image_summary",
+        "type": "string"
+      }
+    },
+    "required": [
+      "type",
+      "result"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": true,
+    "properties": {
+      "type": {
+        "const": "done",
+        "type": "string"
+      }
+    },
+    "required": [
+      "type"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": true,
+    "properties": {
+      "code": {
+        "type": "string"
+      },
+      "message": {
+        "type": "string"
+      },
+      "type": {
+        "const": "error",
+        "type": "string"
+      }
+    },
+    "required": [
+      "type",
+      "message"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": {},
+    "properties": {
+      "type": {
+        "type": "string"
+      }
+    },
+    "required": [
+      "type"
+    ],
+    "type": "object"
+  }
+]

Changed12 schema fields changedOct 2, 2026

addedInput schema / $schema

Added value: +"https://json-schema.org/draft/2020-12/schema"

removedInput schema / properties / headline / description

Removed value: -"Optional descriptor to disambiguate, e.g. 'Engineer, London'."

addedInput schema / properties / headline / maxLength
```
Added value: +500
```

addedInput schema / properties / idempotency_key

Added value: +{
+  "description": "Reuse this key when retrying the same inputs.",
+  "maxLength": 255,
+  "minLength": 1,
+  "type": "string"
+}

removedInput schema / properties / name / description
```
Removed value: -"The person's full name."
```
addedInput schema / properties / name / maxLength
```
Added value: +180
```
addedInput schema / properties / name / minLength
```
Added value: +1
```

removedInput schema / properties / refresh / description

Removed value: -"Rebuild from scratch instead of using the shared cache. Always meters."

addedInput schema / properties / sandbox
```
Added value: +{
+  "type": "boolean"
+}
```

removedInput schema / properties / username / description

Removed value: -"Optional known handle to focus the profile on the right person."

addedInput schema / properties / username / maxLength
```
Added value: +80
```

changedOutput schema / (root)

Previous value: -nullNew value: +{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "additionalProperties": true,
+  "properties": {
+    "cached": {
+      "type": "boolean"
+    },
+    "dossier": {
+      "additionalProperties": true,
+      "properties": {
+        "sections": {
+          "additionalProperties": {},
+          "properties": {
+            "contact": {
+              "additionalProperties": true,
+              "default": {
+                "emails": [],
+                "phones": []
+              },
+              "properties": {
+                "emails": {
+                  "default": [],
+                  "items": {
+                    "type": "string"
+                  },
+                  "type": "array"
+                },
+                "phones": {
+                  "default": [],
+                  "items": {
+                    "type": "string"
+                  },
+                  "type": "array"
+                },
+                "telegram": {
+                  "anyOf": [
+                    {
+                      "type": "string"
+                    },
+                    {
+                      "type": "boolean"
+                    }
+                  ]
+                },
+                "whatsapp": {
+                  "type": "boolean"
+                }
+              },
+              "required": [
+                "emails",
+                "phones"
+              ],
+              "type": "object"
+            },
+            "dating": {
+              "default": [],
+              "items": {
+                "additionalProperties": true,
+                "properties": {
+                  "note": {
+                    "type": "string"
+                  },
+                  "platform": {
+                    "type": "string"
+                  },
+                  "url": {
+                    "type": "string"
+                  }
+                },
+                "required": [
+                  "platform"
+                ],
+                "type": "object"
+              },
+              "type": "array"
+            },
+            "education": {
+              "default": [],
+              "items": {
+                "additionalProperties": true,
+                "properties": {
+                  "field": {
+                    "type": "string"
+                  },
+                  "period": {
+                    "type": "string"
+                  },
+                  "school": {
+                    "type": "string"
+                  }
+                },
+                "required": [
+                  "school"
+                ],
+                "type": "object"
+              },
+              "type": "array"
+            },
+            "identity": {
+              "additionalProperties": {},
+              "properties": {
+                "age": {
+                  "exclusiveMinimum": 0,
+                  "maximum": 9007199254740991,
+                  "type": "integer"
+                },
+                "avatarCandidates": {
+                  "items": {
+                    "format": "uri",
+                    "type": "string"
+                  },
+                  "maxItems": 10,
+                  "type": "array"
+                },
+                "avatarContext": {
+                  "enum": [
+                    "account",
+                    "authority",
+                    "submitted",
+                    "subject"
+                  ],
+                  "type": "string"
+                },
+                "avatarUrl": {
+                  "format": "uri",
+                  "type": "string"
+                },
+                "confidence": {
+                  "maximum": 100,
+                  "minimum": 0,
+                  "type": "number"
+                },
+                "headline": {
+                  "maxLength": 500,
+                  "type": "string"
+                },
+                "id": {
+                  "minLength": 1,
+                  "type": "string"
+                },
+                "identityContext": {
+                  "enum": [
+                    "account",
+                    "authority",
+                    "submitted"
+                  ],
+                  "type": "string"
+                },
+                "initials": {
+                  "maxLength": 8,
+                  "minLength": 1,
+                  "type": "string"
+                },
+                "location": {
+                  "maxLength": 500,
+                  "type": "string"
+                },
+                "name": {
+                  "maxLength": 180,
+                  "minLength": 1,
+                  "type": "string"
+                },
+                "primaryPlatform": {
+                  "enum": [
+                    "instagram",
+                    "facebook",
+                    "x",
+                    "twitter",
+                    "tiktok",
+                    "linkedin",
+                    "youtube",
+                    "whatsapp",
+                    "telegram",
+                    "snapchat",
+                    "reddit",
+                    "threads",
+                    "bluesky",
+                    "mastodon",
+                    "pinterest",
+                    "twitch",
+                    "discord",
+                    "tinder",
+                    "bumble",
+                    "hinge",
+                    "onlyfans",
+                    "fansly",
+                    "patreon",
+                    "cameo",
+                    "vsco",
+                    "tumblr",
+                    "flickr",
+                    "strava",
+                    "apple_music",
+                    "bandcamp",
+                    "lastfm",
+                    "vimeo",
+                    "letterboxd",
+                    "goodreads",
+                    "quora",
+                    "github",
+                    "stack_overflow",
+                    "hacker_news",
+                    "npm",
+                    "kaggle",
+                    "medium",
+                    "substack",
+                    "product_hunt",
+                    "wellfound",
+                    "crunchbase",
+                    "behance",
+                    "dribbble",
+                    "soundcloud",
+                    "spotify",
+                    "orcid",
+                    "google_scholar",
+                    "researchgate",
+                    "academia",
+                    "linktree",
+                    "personal_website",
+                    "company_page",
+                    "other"
+                  ],
+                  "type": "string"
+                },
+                "primaryUrl": {
+                  "format": "uri",
+                  "type": "string"
+                },
+                "primaryUsername": {
+                  "maxLength": 80,
+                  "type": "string"
+                },
+                "seedEmail": {
+                  "maxLength": 320,
+                  "type": "string"
+                },
+                "seedPhone": {
+                  "maxLength": 80,
+                  "type": "string"
+                },
+                "tags": {
+                  "items": {
+                    "maxLength": 80,
+                    "type": "string"
+                  },
+                  "maxItems": 20,
+                  "type": "array"
+                }
+              },
+              "type": "object"
+            },
+            "locations": {
+              "additionalProperties": true,
+              "default": {
+                "addresses": [],
+                "past": []
+              },
+              "properties": {
+                "addresses": {
+                  "default": [],
+                  "description": "Approximate / public-record locations only - never precise",
+                  "items": {
+                    "type": "string"
+                  },
+                  "type": "array"
+                },
+                "current": {
+                  "type": "string"
+                },
+                "past": {
+                  "default": [],
+                  "items": {
+                    "type": "string"
+                  },
+                  "type": "array"
+                }
+              },
+              "required": [
+                "addresses",
+                "past"
+              ],
+              "type": "object"
+            },
+            "mentions": {
+              "default": [],
+              "items": {
+                "additionalProperties": true,
+                "properties": {
+                  "date": {
+                    "type": "string"
+                  },
+                  "kind": {
+                    "enum": [
+                      "article",
+                      "mention",
+                      "photo",
+                      "profile",
+                      "news"
+                    ],
+                    "type": "string"
+                  },
+                  "snippet": {
+                    "type": "string"
+                  },
+                  "source": {
+                    "type": "string"
+                  },
+                  "title": {
+                    "type": "string"
+                  },
+                  "url": {
+                    "type": "string"
+                  }
+                },
+                "required": [
+                  "title",
+                  "url",
+                  "source"
+                ],
+                "type": "object"
+              },
+              "type": "array"
+            },
+            "photos": {
+              "items": {
+                "type": "string"
+              },
+              "type": "array"
+            },
+            "relationships": {
+              "items": {
+                "additionalProperties": true,
+                "properties": {
+                  "confidence": {
+                    "type": "number"
+                  },
+                  "current": {
+                    "type": "boolean"
+                  },
+                  "note": {
+                    "type": "string"
+                  },
+                  "partner": {
+                    "type": "string"
+                  },
+                  "period": {
+                    "type": "string"
+                  },
+                  "source": {
+                    "type": "string"
+                  },
+                  "sourceName": {
+                    "type": "string"
+                  },
+                  "sourceType": {
+                    "enum": [
+                      "confirmed",
+                      "reported",
+                      "rumored"
+                    ],
+                    "type": "string"
+                  },
+                  "status": {
+                    "type": "string"
+                  }
+                },
+                "required": [
+                  "partner"
+                ],
+                "type": "object"
+              },
+              "type": "array"
+            },
+            "relatives": {
+              "default": [],
+              "items": {
+                "additionalProperties": true,
+                "properties": {
+                  "name": {
+                    "type": "string"
+                  },
+                  "relation": {
+                    "type": "string"
+                  }
+                },
+                "required": [
+                  "name"
+                ],
+                "type": "object"
+              },
+              "type": "array"
+            },
+            "socials": {
+              "default": [],
+              "items": {
+                "additionalProperties": true,
+                "properties": {
+                  "followers": {
+                    "type": "number"
+                  },
+                  "handle": {
+                    "type": "string"
+                  },
+                  "platform": {
+                    "enum": [
+                      "instagram",
+                      "facebook",
+                      "x",
+                      "twitter",
+                      "tiktok",
+                      "linkedin",
+                      "youtube",
+                      "whatsapp",
+                      "telegram",
+                      "snapchat",
+                      "reddit",
+                      "threads",
+                      "bluesky",
+                      "mastodon",
+                      "pinterest",
+                      "twitch",
+                      "discord",
+                      "tinder",
+                      "bumble",
+                      "hinge",
+                      "onlyfans",
+                      "fansly",
+                      "patreon",
+                      "cameo",
+                      "vsco",
+                      "tumblr",
+                      "flickr",
+                      "strava",
+                      "apple_music",
+                      "bandcamp",
+                      "lastfm",
+                      "vimeo",
+                      "letterboxd",
+                      "goodreads",
+                      "quora",
+                      "github",
+                      "stack_overflow",
+                      "hacker_news",
+                      "npm",
+                      "kaggle",
+                      "medium",
+                      "substack",
+                      "product_hunt",
+                      "wellfound",
+                      "crunchbase",
+                      "behance",
+                      "dribbble",
+                      "soundcloud",
+                      "spotify",
+                      "orcid",
+                      "google_scholar",
+                      "researchgate",
+                      "academia",
+                      "linktree",
+                      "personal_website",
+                      "company_page",
+                      "other"
+                    ],
+                    "type": "string"
+                  },
+                  "url": {
+                    "type": "string"
+                  },
+                  "verified": {
+                    "type": "boolean"
+                  }
+                },
+                "required": [
+                  "platform"
+                ],
+                "type": "object"
+              },
+              "type": "array"
+            },
+            "work": {
+              "default": [],
+              "items": {
+                "additionalProperties": true,
+                "properties": {
+                  "current": {
+                    "type": "boolean"
+                  },
+                  "org": {
+                    "type": "string"
+                  },
+                  "period": {
+                    "type": "string"
+                  },
+                  "title": {
+                    "type": "string"
+                  }
+                },
+                "required": [
+                  "org"
+                ],
+                "type": "object"
+              },
+              "type": "array"
+            }
+          },
+          "type": "object"
+        },
+        "sources": {
+          "items": {
+            "additionalProperties": {},
+            "properties": {
+              "authorImageUrl": {
+                "type": "string"
+              },
+              "authorName": {
+                "type": "string"
+              },
+              "cited": {
+                "type": "boolean"
+              },
+              "domain": {
+                "type": "string"
+              },
+              "id": {
+                "type": "string"
+              },
+              "position": {
+                "type": "number"
+              },
+              "publishedAt": {
+                "type": "string"
+              },
+              "snippet": {
+                "type": "string"
+              },
+              "title": {
+                "type": "string"
+              },
+              "url": {
+                "type": "string"
+              }
+            },
+            "required": [
+              "id",
+              "position",
+              "url",
+              "title",
+              "domain"
+            ],
+            "type": "object"
+          },
+          "type": "array"
+        },
+        "summary": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "summary",
+        "sections",
+        "sources"
+      ],
+      "type": "object"
+    },
+    "events": {
+      "items": {
+        "anyOf": [
+          {
+            "additionalProperties": true,
+            "properties": {
+              "hit": {
+                "anyOf": [
+                  {
+                    "additionalProperties": {},
+                    "properties": {
+                      "age": {
+                        "exclusiveMinimum": 0,
+                        "maximum": 9007199254740991,
+                        "type": "integer"
+                      },
+                      "avatarCandidates": {
+                        "items": {
+                          "format": "uri",
+                          "type": "string"
+                        },
+                        "maxItems": 10,
+                        "type": "array"
+                      },
+                      "avatarContext": {
+                        "enum": [
+                          "account",
+                          "authority",
+                          "submitted",
+                          "subject"
+                        ],
+                        "type": "string"
+                      },
+                      "avatarUrl": {
+                        "format": "uri",
+                        "type": "string"
+                      },
+                      "confidence": {
+                        "type": "number"
+                      },
+                      "headline": {
+                        "maxLength": 500,
+                        "type": "string"
+                      },
+                      "id": {
+                        "type": "string"
+                      },
+                      "identityContext": {
+                        "enum": [
+                          "account",
+                          "authority",
+                          "submitted"
+                        ],
+                        "type": "string"
+                      },
+                      "initials": {
+                        "type": "string"
+                      },
+                      "kind": {
+                        "const": "person",
+                        "type": "string"
+                      },
+                      "location": {
+                        "maxLength": 500,
+                        "type": "string"
+                      },
+                      "name": {
+                        "maxLength": 180,
+                        "minLength": 1,
+                        "type": "string"
+                      },
+                      "primaryPlatform": {
+                        "enum": [
+                          "instagram",
+                          "facebook",
+                          "x",
+                          "twitter",
+                          "tiktok",
+                          "linkedin",
+                          "youtube",
+                          "whatsapp",
+                          "telegram",
+                          "snapchat",
+                          "reddit",
+                          "threads",
+                          "bluesky",
+                          "mastodon",
+                          "pinterest",
+                          "twitch",
+                          "discord",
+                          "tinder",
+                          "bumble",
+                          "hinge",
+                          "onlyfans",
+                          "fansly",
+                          "patreon",
+                          "cameo",
+                          "vsco",
+                          "tumblr",
+                          "flickr",
+                          "strava",
+                          "apple_music",
+                          "bandcamp",
+                          "lastfm",
+                          "vimeo",
+                          "letterboxd",
+                          "goodreads",
+                          "quora",
+                          "github",
+                          "stack_overflow",
+                          "hacker_news",
+                          "npm",
+                          "kaggle",
+                          "medium",
+                          "substack",
+                          "product_hunt",
+                          "wellfound",
+                          "crunchbase",
+                          "behance",
+                          "dribbble",
+                          "soundcloud",
+                          "spotify",
+                          "orcid",
+                          "google_scholar",
+                          "researchgate",
+                          "academia",
+                          "linktree",
+                          "personal_website",
+                          "company_page",
+                          "other"
+                        ],
+                        "type": "string"
+                      },
+                      "primaryUrl": {
+                        "format": "uri",
+                        "type": "string"
+                      },
+                      "primaryUsername": {
+                        "maxLength": 80,
+                        "type": "string"
+                      },
+                      "seedEmail": {
+                        "maxLength": 320,
+                        "type": "string"
+                      },
+                      "seedPhone": {
+                        "maxLength": 80,
+                        "type": "string"
+                      },
+                      "tags": {
+                        "items": {
+                          "type": "string"
+                        },
+                        "type": "array"
+                      }
+                    },
+                    "required": [
+                      "id",
+                      "name",
+                      "initials",
+                      "confidence",
+                      "tags"
+                    ],
+                    "type": "object"
+                  },
+                  {
+                    "additionalProperties": {},
+                    "properties": {
+                      "confidence": {
+                        "type": "number"
+                      },
+                      "domain": {
+                        "maxLength": 255,
+                        "type": "string"
+                      },
+                      "headline": {
+                        "maxLength": 500,
+                        "type": "string"
+                      },
+                      "id": {
+                        "type": "string"
+                      },
+                      "initials": {
+                        "type": "string"
+                      },
+                      "jurisdiction": {
+                        "maxLength": 120,
+                        "type": "string"
+                      },
+                      "kind": {
+                        "const": "company",
+                        "type": "string"
+                      },
+                      "legalName": {
+                        "maxLength": 180,
+                        "type": "string"
+                      },
+                      "logoUrl": {
+                        "format": "uri",
+                        "type": "string"
+                      },
+                      "name": {
+                        "maxLength": 180,
+                        "minLength": 1,
+                        "type": "string"
+                      },
+                      "seedDomain": {
+                        "maxLength": 255,
+                        "type": "string"
+                      },
+                      "seedRegistryId": {
+                        "maxLength": 120,
+                        "type": "string"
+                      },
+                      "seedRegistrySource": {
+                        "maxLength": 80,
+                        "type": "string"
+                      },
+                      "status": {
+                        "enum": [
+                          "active",
+                          "dissolved",
+                          "unknown"
+                        ],
+                        "type": "string"
+                      },
+                      "tags": {
+                        "items": {
+                          "type": "string"
+                        },
+                        "type": "array"
+                      }
+                    },
+                    "required": [
+                      "id",
+                      "name",
+                      "initials",
+                      "confidence",
+                      "tags",
+                      "kind"
+                    ],
+                    "type": "object"
+                  }
+                ]
+              },
+              "type": {
+                "const": "hit",
+                "type": "string"
+              }
+            },
+            "required": [
+              "type",
+              "hit"
+            ],
+            "type": "object"
+          },
+          {
+            "additionalProperties": true,
+            "properties": {
+              "delta": {
+                "type": "string"
+              },
+              "type": {
+                "const": "text",
+                "type": "string"
+              }
+            },
+            "required": [
+              "type",
+              "delta"
+            ],
+            "type": "object"
+          },
+          {
+            "additionalProperties": true,
+            "properties": {
+              "delta": {
+                "type": "string"
+              },
+              "type": {
+                "const": "summary",
+                "type": "string"
+              }
+            },
+            "required": [
+              "type",
+              "delta"
+            ],
+            "type": "object"
+          },
+          {
+            "additionalProperties": true,
+            "properties": {
+              "sources": {
+                "items": {
+                  "additionalProperties": {},
+                  "properties": {
+                    "authorImageUrl": {
+                      "type": "string"
+                    },
+                    "authorName": {
+                      "type": "string"
+                    },
+                    "cited": {
+                      "type": "boolean"
+                    },
+                    "domain": {
+                      "type": "string"
+                    },
+                    "id": {
+                      "type": "string"
+                    },
+                    "position": {
+                      "type": "number"
+                    },
+                    "publishedAt": {
+                      "type": "string"
+                    },
+                    "snippet": {
+                      "type": "string"
+                    },
+                    "title": {
+                      "type": "string"
+                    },
+                    "url": {
+                      "type": "string"
+                    }
+                  },
+                  "required": [
+                    "id",
+                    "position",
+                    "url",
+                    "title",
+                    "domain"
+                  ],
+                  "type": "object"
+                },
+                "type": "array"
+              },
+              "type": {
+                "const": "sources",
+                "type": "string"
+              }
+            },
+            "required": [
+              "type",
+              "sources"
+            ],
+            "type": "object"
+          },
+          {
+            "additionalProperties": true,
+            "properties": {
+              "questions": {
+                "items": {
+                  "type": "string"
+                },
+                "type": "array"
+              },
+              "type": {
+                "const": "related",
+                "type": "string"
+              }
+            },
+            "required": [
+              "type",
+              "questions"
+            ],
+            "type": "object"
+          },
+          {
+            "additionalProperties": true,
+            "properties": {
+              "data": {},
+              "key": {
+                "enum": [
+                  "identity",
+                  "photos",
+                  "contact",
+                  "socials",
+                  "locations",
+                  "relatives",
+                  "work",
+                  "education",
+                  "mentions",
+                  "dating",
+                  "relationships"
+                ],
+                "type": "string"
+              },
+              "type": {
+                "const": "section",
+                "type": "string"
+              }
+            },
+            "required": [
+              "type",
+              "key",
+              "data"
+            ],
+            "type": "object"
+          },
+          {
+            "additionalProperties": true,
+            "properties": {
+              "data": {},
+              "key": {
+                "enum": [
+                  "identity",
+                  "registration",
+                  "industry",
+                  "financials",
+                  "funding",
+                  "executives",
+                  "locations",
+                  "linkage",
+                  "contact",
+                  "mentions"
+                ],
+                "type": "string"
+              },
+              "type": {
+                "const": "entity_section",
+                "type": "string"
+              }
+            },
+            "required": [
+              "type",
+              "key",
+              "data"
+            ],
+            "type": "object"
+          },
+          {
+            "additionalProperties": true,
+            "properties": {
+              "data": {},
+              "key": {
+                "enum": [
+                  "identity",
+                  "engine",
+                  "safety",
+                  "recalls",
+                  "history"
+                ],
+                "type": "string"
+              },
+              "type": {
+                "const": "vehicle_section",
+                "type": "string"
+              }
+            },
+            "required": [
+              "type",
+              "key",
+              "data"
+            ],
+            "type": "object"
+          },
+          {
+            "additionalProperties": true,
+            "properties": {
+              "match": {
+                "additionalProperties": {},
+                "properties": {
+                  "date": {
+                    "type": "string"
+                  },
+                  "imageUrl": {
+                    "type": "string"
+                  },
+                  "matchKind": {
+                    "type": "string"
+                  },
+                  "snippet": {
+                    "type": "string"
+                  },
+                  "sourceDomain": {
+                    "type": "string"
+                  },
+                  "thumbnailUrl": {
+                    "type": "string"
+                  },
+                  "title": {
+                    "type": "string"
+                  },
+                  "url": {
+                    "type": "string"
+                  }
+                },
+                "required": [
+                  "url",
+                  "sourceDomain"
+                ],
+                "type": "object"
+              },
+              "type": {
+                "const": "image_match",
+                "type": "string"
+              }
+            },
+            "required": [
+              "type",
+              "match"
+            ],
+            "type": "object"
+          },
+          {
+            "additionalProperties": true,
+            "properties": {
+              "image": {
+                "additionalProperties": {},
+                "properties": {
+                  "imageUrl": {
+                    "type": "string"
+                  },
+                  "sourceDomain": {
+                    "type": "string"
+                  },
+                  "sourceUrl": {
+                    "type": "string"
+                  },
+                  "thumbnailUrl": {
+                    "type": "string"
+                  },
+                  "title": {
+                    "type": "string"
+                  }
+                },
+                "required": [
+                  "imageUrl"
+                ],
+                "type": "object"
+              },
+              "type": {
+                "const": "similar_image",
+                "type": "string"
+              }
+            },
+            "required": [
+              "type",
+              "image"
+            ],
+            "type": "object"
+          },
+          {
+            "additionalProperties": true,
+            "properties": {
+              "result": {
+                "additionalProperties": {},
+                "properties": {
+                  "matches": {
+                    "items": {
+                      "additionalProperties": {},
+                      "properties": {
+                        "date": {
+                          "type": "string"
+                        },
+                        "imageUrl": {
+                          "type": "string"
+                        },
+                        "matchKind": {
+                          "type": "string"
+                        },
+                        "snippet": {
+                          "type": "string"
+                        },
+                        "sourceDomain": {
+                          "type": "string"
+                        },
+                        "thumbnailUrl": {
+                          "type": "string"
+                        },
+                        "title": {
+                          "type": "string"
+                        },
+                        "url": {
+                          "type": "string"
+                        }
+                      },
+                      "required": [
+                        "url",
+                        "sourceDomain"
+                      ],
+                      "type": "object"
+                    },
+                    "type": "array"
+                  },
+                  "provider": {
+                    "type": "string"
+                  },
+                  "similar": {
+                    "items": {
+                      "additionalProperties": {},
+                      "properties": {
+                        "imageUrl": {
+                          "type": "string"
+                        },
+                        "sourceDomain": {
+                          "type": "string"
+                        },
+                        "sourceUrl": {
+                          "type": "string"
+                        },
+                        "thumbnailUrl": {
+                          "type": "string"
+                        },
+                        "title": {
+                          "type": "string"
+                        }
+                      },
+                      "required": [
+                        "imageUrl"
+                      ],
+                      "type": "object"
+                    },
+                    "type": "array"
+                  }
+                },
+                "required": [
+                  "provider"
+                ],
+                "type": "object"
+              },
+              "type": {
+                "const": "image_summary",
+                "type": "string"
+              }
+            },
+            "required": [
+              "type",
+              "result"
+            ],
+            "type": "object"
+          },
+          {
+            "additionalProperties": true,
+            "properties": {
+              "type": {
+                "const": "done",
+                "type": "string"
+              }
+            },
+            "required": [
+              "type"
+            ],
+            "type": "object"
+          },
+          {
+            "additionalProperties": true,
+            "properties": {
+              "code": {
+                "type": "string"
+              },
+              "message": {
+                "type": "string"
+              },
+              "type": {
+                "const": "error",
+                "type": "string"
+              }
+            },
+            "required": [
+              "type",
+              "message"
+            ],
+            "type": "object"
+          },
+          {
+            "additionalProperties": {},
+            "properties": {
+              "type": {
+                "type": "string"
+              }
+            },
+            "required": [
+              "type"
+            ],
+            "type": "object"
+          }
+        ]
+      },
+      "type": "array"
+    },
+    "metadata": {
+      "additionalProperties": true,
+      "properties": {
+        "api_version": {
+          "const": "v1",
+          "type": "string"
+        },
+        "generated_at": {
+          "type": "string"
+        },
+        "operation": {
+          "enum": [
+            "search",
+            "dossier",
+            "chat",
+            "entity_search",
+            "entity_dossier",
+            "reverse_image",
+            "vin"
+          ],
+          "type": "string"
+        },
+        "request_id": {
+          "type": "string"
+        },
+        "sandbox": {
+          "type": "boolean"
+        }
+      },
+      "required": [
+        "api_version",
+        "operation",
+        "request_id",
+        "generated_at"
+      ],
+      "type": "object"
+    },
+    "object": {
+      "const": "dossier_result",
+      "type": "string"
+    },
+    "request_id": {
+      "type": "string"
+    },
+    "status": {
+      "const": "partial",
+      "type": "string"
+    },
+    "usage": {
+      "additionalProperties": true,
+      "properties": {
+        "allowanceSource": {
+          "enum": [
+            "weekly",
+            "coin"
+          ],
+          "type": "string"
+        },
+        "cached": {
+          "type": "boolean"
+        },
+        "credits": {
+          "type": "number"
+        },
+        "idempotencyKey": {
+          "type": "string"
+        },
+        "metered": {
+          "type": "boolean"
+        },
+        "percentageCharged": {
+          "type": "number"
+        },
+        "remainingPercent": {
+          "type": "number"
+        },
+        "replayed": {
+          "type": "boolean"
+        },
+        "resetAt": {
+          "type": "string"
+        },
+        "sandbox": {
+          "type": "boolean"
+        },
+        "source": {
+          "enum": [
+            "included",
+            "extra",
+            "mixed"
+          ],
+          "type": "string"
+        }
+      },
+      "required": [
+        "metered",
+        "credits"
+      ],
+      "type": "object"
+    },
+    "warning": {
+      "type": "string"
+    }
+  },
+  "required": [
+    "request_id",
+    "metadata",
+    "usage",
+    "events",
+    "object",
+    "cached",
+    "dossier"
+  ],
+  "type": "object"
+}

Changed9 schema fields changedSep 9, 2026

removedInput schema / additionalProperties
```
Removed value: -false
```

addedInput schema / properties / headline

Added value: +{
+  "description": "Optional descriptor to disambiguate, e.g. 'Engineer, London'.",
+  "type": "string"
+}

changedInput schema / properties / name / description

Previous value: -"The person's name, not a phone number, email, or handle."New value: +"The person's full name."

removedInput schema / properties / name / maxLength
```
Removed value: -100
```
removedInput schema / properties / name / minLength
```
Removed value: -2
```

removedInput schema / properties / profile_url

Removed value: -{
-  "description": "The profileUrl of the professional source selected from search_people. Never infer account ownership.",
-  "maxLength": 400,
-  "type": "string"
-}

addedInput schema / properties / refresh

Added value: +{
+  "description": "Rebuild from scratch instead of using the shared cache. Always meters.",
+  "type": "boolean"
+}

addedInput schema / properties / username

Added value: +{
+  "description": "Optional known handle to focus the profile on the right person.",
+  "type": "string"
+}

changedInput schema / required

Previous value: -[
-  "name",
-  "profile_url"
-]New value: +[
+  "name"
+]

Changed9 schema fields changedSep 9, 2026

addedInput schema / additionalProperties
```
Added value: +false
```

removedInput schema / properties / headline

Removed value: -{
-  "description": "Optional descriptor to disambiguate, e.g. 'Engineer, London'.",
-  "type": "string"
-}

changedInput schema / properties / name / description

Previous value: -"The person's full name."New value: +"The person's name, not a phone number, email, or handle."

addedInput schema / properties / name / maxLength
```
Added value: +100
```
addedInput schema / properties / name / minLength
```
Added value: +2
```

addedInput schema / properties / profile_url

Added value: +{
+  "description": "The profileUrl of the professional source selected from search_people. Never infer account ownership.",
+  "maxLength": 400,
+  "type": "string"
+}

removedInput schema / properties / refresh

Removed value: -{
-  "description": "Rebuild from scratch instead of using the shared cache. Always meters.",
-  "type": "boolean"
-}

removedInput schema / properties / username

Removed value: -{
-  "description": "Optional known handle to focus the profile on the right person.",
-  "type": "string"
-}

changedInput schema / required

Previous value: -[
-  "name"
-]New value: +[
+  "name",
+  "profile_url"
+]

First observedAug 19, 2026

TDQS

A4.5/5.0

Behavior5/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With annotations already covering readOnly/openWorld/non-destructive, the description still adds substantial operational context: repeat requests replay a cached profile for free, caches are per-account and not shared, only public sources are used (no private accounts or breach data), dossier scope is required, and provider calls consume account usage while cached hits do not.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Purpose is front-loaded and each subsequent sentence adds distinct value (routing, caching, isolation, source limits, scope, cost). It is a long single block rather than a structured list, but there is no filler or repetition.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

An output schema exists so return values needn't be explained, and the description covers scope, cost, caching, and source restrictions. Remaining gaps are the refresh/sandbox parameters and whether the call is synchronous or job-based, which the sibling job tools suggest could matter.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is only 17% (just idempotency_key), so the description must compensate. It does clarify name/headline/username semantics and implies refresh via the caching statement, but sandbox and the explicit refresh toggle remain undocumented in both description and schema.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

Specific verb (assemble) plus resource (one person's public footprint) with an enumerated payload: identity, contact details, unified social accounts, work history, education, relatives, locations, web mentions, all sourced. It explicitly distinguishes itself from doing a web search and points to sibling search_people as the source of inputs, so an agent can place it without opening another schema.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines5/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Explicit when-to-use: "Prefer this over reading search results yourself when you need the whole picture of one person rather than a single fact." It names the alternative (web search) and the prerequisite inputs (name plus headline or username from search_people), leaving little to inference.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

All DeepSearch tools Inspect

Try in Browser

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources

Need Help?