Enrich Lead via Navigator

Submit lead input (name and optional company, job title, location, etc.). Navigator searches for a matching X (Twitter) profile. If a match is found, returns the full lead (same structure as the add-lead-to-campaign JSON payload) and deducts 1 Navigator credit. If no match is found, returns match: null and does not deduct any credit. The returned lead can be passed directly to Add lead to campaign (JSON import) if desired.

POST /navigator/enrich

Enrich lead via Navigator

cURL

curl --request POST \
  --url https://app.drippi.ai/api/v1/navigator/enrich \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "fullName": "<string>",
  "website": "<string>",
  "company": "<string>",
  "jobTitle": "<string>",
  "location": "<string>",
  "headline": "<string>"
}
'

200

{
  "status": "success",
  "match": {
    "id": "<string>",
    "name": "<string>",
    "username": "<string>",
    "created_at": "<string>",
    "profile_image_url": "<string>",
    "public_metrics": {
      "followers_count": 123,
      "following_count": 123,
      "tweet_count": 123,
      "listed_count": 123
    },
    "protected": true,
    "location": "<string>",
    "url": "<string>",
    "description": "<string>",
    "verified": true,
    "entities": {},
    "pinned_tweet_id": "<string>",
    "gqlId": "<string>"
  },
  "creditsUsed": 1
}

Submit lead input (either fullName or firstName + lastName, plus optional fields like company, job title, location, headline). Navigator searches for a matching X (Twitter) profile. If a match is found, the API returns the full lead in the same structure as the Add lead to campaign JSON payload, and one Navigator credit is deducted. If no match is found, the response has match: null and no credit is deducted.

The returned match object can be passed directly to Add lead to campaign (using importType: "json" and json: match) to add that lead to a campaign without a second lookup.

Navigator credits are deducted only when a match is returned. No match means no deduction.

Authorizations

x-api-key · string · header · required

API key for authentication

Body

application/json

Option 1

Option 2

Provide either fullName or firstName+lastName.

fullName · string · required

Full name (first + last). Will be split into firstName/lastName internally.

website · string

Optional website URL

company · string

Optional company name

jobTitle · string

Optional job title

location · string

Optional location

headline · string

Optional headline/bio (can contain @handle for faster match)

Response

200

application/json

Enrichment completed. match is the full lead when found, or null when no match. creditsUsed is 1 when a match was found (1 Navigator credit deducted); omitted when no match.

status · string

Example:

"success"

match · object

Full lead (same structure as add-lead-to-campaign json). Null if no match.

Option 1

Option 2

Show child attributes

creditsUsed · integer

Navigator credits deducted (1 when match found; omitted when no match).

Example:

1