Skip to main content
POST
/
api
/
v2
/
lookups
/
enrich
Lookup: enrich an X handle
curl --request POST \
  --url https://api.example.com/api/v2/lookups/enrich
One-shot enrichment for the Chrome extension and external integrators that don’t have a lead row yet. For a known lead row, use Enrich a lead.

​
Body

FieldTypeDescription
x_handlestringExactly one of x_handle or x_profile_id
x_profile_idstringExactly one of x_handle or x_profile_id
requested_outputsarray (required)["linkedin_url"], ["email"], or both
email_modeenum"verified" or "any". Default "any".
max_cost_creditsnumberSoft cap. Default 5.

​
Response

{
  "enrichment_request_id": 999,
  "status": "complete",
  "actual_cost_credits": 2,
  "credit_consumed": true,
  "credits_remaining": 47,
  "contact_routes": [
    { "route_type": "linkedin_url", "value": "https://linkedin.com/in/alice", "confidence": "high", "provider": "scrapebadger_serp" }
  ],
  "linkedin": { "url": "...", "confidence": "high", "alternatives": [], "provider": "scrapebadger_serp" },
  "email": { "value": "alice@acme.com", "status": "verified", "provider": "prospeo" }
}

​
Errors

CodeHTTPWhen
missing_identifier400Neither x_handle nor x_profile_id supplied
ambiguous_identifier400Both supplied
x_handle_not_found404Handle didn’t resolve
credits_exhausted429Insufficient balance
profile_fetch_failed503Upstream X lookup down

​
Auth

Bearer API key (extension or manual). Both debit from team credit balance.