Skip to main content
POST /v1/entity-search accepts one JSON object and returns a Server-Sent Events stream.

Headers

Request body

The complete request body must be at most 1 MiB. Unknown fields, malformed JSON, and multiple JSON objects are rejected.

Supported entity types

  • person
  • company
  • twitter_creator
  • youtube_creator
  • tiktok_creator
  • instagram_creator
  • shopify_store
A supported type can still return 503 service_unavailable when it is not enabled or priced for the current environment. Access is rolled out per entity type.

Example request

Response

On success, the response status is 200, Content-Type is text/event-stream, and X-Request-Id contains the lev8 request ID. Read the stream as described in Streaming events. The entities array is returned as live-web result data. Common fields include name, links, description, score, and requested enrichment data. Available fields vary by entity type and enrichment configuration; clients should ignore unknown fields and tolerate absent optional fields.