agents

Score ICP fit

Transport: call this endpoint with HTTP POST and a JSON request body. Score a prospect 1-5 on ideal customer profile fit based on industry, role, company size, location, and your stored ICP criteria.

post/v1/agents/icpScore

Request

  • Base URL: https://api.zevari.ai
  • URL: https://api.zevari.ai/v1/agents/icpScore
  • Auth: HTTP bearer

Request body

identifierstring required

LinkedIn public identifier or provider ID to score

scoring_mode'auto' | 'cached' | 'live'

How to source the lead data for scoring. auto: cache-first triage with a live fetch escalation for borderline or high-stakes cases; cached: score from stored lead data only, never fetching; live: always fetch a fresh LinkedIn profile before scoring. Defaults to auto.

target_industrystring

Target industry for ICP (falls back to stored profile)

target_rolestring

Target role/title (falls back to stored profile)

target_company_sizestring

Target company size (falls back to stored profile)

target_locationstring

Target location (falls back to stored profile)

product_offeringstring

What you sell (falls back to stored profile)

company_descriptionstring

Your company description (falls back to stored profile)

Response

Successful Zevari API response.

okboolean required

False when the underlying tool reports an error or a partial failure.

methodstring required

Public API method name.

dataunknown required
request_idstring required

Request correlation ID. Also returned in X-Zevari-Request-Id.

Example response

{
  "method": "campaigns.delete"
}

Changes

No recorded changes to this operation across all 1 revision of this API.