Create task

curl --request POST \
  --url https://app.lev8.com/v1/entity-search/create_task \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "entity_type": "company",
  "objective": "AI startups that raised Series A in 2024",
  "limit": 20,
  "enable_web_search": false,
  "enrich_fields": [
    "funding stage",
    "headcount"
  ],
  "dedup_lev8_leads": [],
  "dedup_custom_leads": []
}
'

const options = {
  method: 'POST',
  headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    entity_type: 'company',
    objective: 'AI startups that raised Series A in 2024',
    limit: 20,
    enable_web_search: false,
    enrich_fields: ['funding stage', 'headcount'],
    dedup_lev8_leads: [],
    dedup_custom_leads: []
  })
};

fetch('https://app.lev8.com/v1/entity-search/create_task', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://app.lev8.com/v1/entity-search/create_task"

payload = {
    "entity_type": "company",
    "objective": "AI startups that raised Series A in 2024",
    "limit": 20,
    "enable_web_search": False,
    "enrich_fields": ["funding stage", "headcount"],
    "dedup_lev8_leads": [],
    "dedup_custom_leads": []
}
headers = {
    "x-api-key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

{
  "object": "<string>",
  "leads_search_id": "leads_search_01JABCDEF123456789",
  "entity_type": "company",
  "objective": "AI startups that raised Series A in 2024",
  "limit": 20,
  "status": "created",
  "created_at": "2026-08-04T00:00:00Z"
}

{
  "object": "<string>",
  "error": {
    "type": "<string>",
    "message": "<string>",
    "param": "<string>",
    "request_id": "<string>"
  }
}

POST

entity-search

create_task

Create task

curl --request POST \
  --url https://app.lev8.com/v1/entity-search/create_task \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "entity_type": "company",
  "objective": "AI startups that raised Series A in 2024",
  "limit": 20,
  "enable_web_search": false,
  "enrich_fields": [
    "funding stage",
    "headcount"
  ],
  "dedup_lev8_leads": [],
  "dedup_custom_leads": []
}
'

const options = {
  method: 'POST',
  headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    entity_type: 'company',
    objective: 'AI startups that raised Series A in 2024',
    limit: 20,
    enable_web_search: false,
    enrich_fields: ['funding stage', 'headcount'],
    dedup_lev8_leads: [],
    dedup_custom_leads: []
  })
};

fetch('https://app.lev8.com/v1/entity-search/create_task', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://app.lev8.com/v1/entity-search/create_task"

payload = {
    "entity_type": "company",
    "objective": "AI startups that raised Series A in 2024",
    "limit": 20,
    "enable_web_search": False,
    "enrich_fields": ["funding stage", "headcount"],
    "dedup_lev8_leads": [],
    "dedup_custom_leads": []
}
headers = {
    "x-api-key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

{
  "object": "<string>",
  "leads_search_id": "leads_search_01JABCDEF123456789",
  "entity_type": "company",
  "objective": "AI startups that raised Series A in 2024",
  "limit": 20,
  "status": "created",
  "created_at": "2026-08-04T00:00:00Z"
}

{
  "object": "<string>",
  "error": {
    "type": "<string>",
    "message": "<string>",
    "param": "<string>",
    "request_id": "<string>"
  }
}

Creates an Entity Search task and returns a leads_search_id for later status and fetch calls.

Example

curl "https://app.lev8.com/v1/entity-search/create_task" \
  --request POST \
  --header "Content-Type: application/json" \
  --header "x-api-key: $LEV8_API_KEY" \
  --data '{
    "entity_type": "company",
    "objective": "AI startups that raised Series A in 2024",
    "limit": 20,
    "enrich_fields": ["funding stage", "headcount"]
  }'

Response

{
  "object": "entity_search_task",
  "leads_search_id": "leads_search_01JABCDEF123456789",
  "entity_type": "company",
  "objective": "AI startups that raised Series A in 2024",
  "limit": 20,
  "status": "created",
  "created_at": "2026-08-04T00:00:00Z"
}

See Entity Search for entity types, deduplication, enrichment, and web search guidance.

Authorizations

x-api-key

string

header

default:lev8_live_...

required

Body

application/json

entity_type

enum<string>

required

Available options:

person,

company,

twitter_creator,

youtube_creator,

tiktok_creator,

instagram_creator,

shopify_store

Example:

"company"

objective

string

required

Example:

"AI startups that raised Series A in 2024"

limit

integer

default:20

Example:

20

enable_web_search

boolean

default:false

Example:

false

enrich_fields

string[] | null

Example:

["funding stage", "headcount"]

dedup_lev8_leads

string[]

Example:

[]

dedup_custom_leads

string[]

Example:

[]

Response

Task created.

object

string

Allowed value: "entity_search_task"

leads_search_id

string

Example:

"leads_search_01JABCDEF123456789"

entity_type

string

Example:

"company"

objective

string

Example:

"AI startups that raised Series A in 2024"

limit

integer

Example:

20

status

string

Example:

"created"

created_at

string<date-time>

Example:

"2026-08-04T00:00:00Z"

⌘I

Getting started

API reference

API behavior

Create task

Example

Response

Authorizations

Body

Response

​Example

​Response

Authorizations

Body

Response

Example

Response