Skip to content

Person B2B social

POST https://api.kingminos.com/v1/person/b2b-social

Try it in the console

Send a person’s email (top level or under person). It is required: it is the one key KingMinos looks the person up by. You get back the person’s LinkedIn profile URL, for CRM profile-URL stamps and social sequencing.

Three inputs are match-only. They only reject a wrong answer and never discover or score anything:

  • linkedin_url rejects a profile with a different slug (person_mismatch). A LinkedIn company page is 400 invalid_linkedin_url.
  • first_name / last_name reject a profile that belongs to someone else (person_mismatch).

person.b2b_social answers for API tenant keys (osr_…). It does not stamp Salesforce Contacts or Leads.

Terminal window
curl 'https://api.kingminos.com/v1/person/b2b-social' \
  -H 'Authorization: Bearer <your-key>' \
  -H 'Content-Type: application/json' \
  -d '{
    "email": "anna@example.com",
    "first_name": "Anna",
    "last_name": "Example",
    "routing": { "path": "accuracy" }
  }'

Paths and price

Section titled “Paths and price”

You pay for the outcome, not the call. A hit bills the path’s price once. A miss, a person mismatch, an answer below your confidence floor and a timeout cost 0.

routing.path What it does Credits on a hit
speed One email-keyed profile lookup, with a fallback source only when the first answers nothing. Never high confidence. 2
balance (default) Email-keyed sources in turn. Stops at the first profile. 3
accuracy Always two independent email-keyed sources, with a 10 s cap. Agreement gives high confidence. 5

There is no coverage path: a profile URL is one answer. coverage returns 400 invalid_routing.

Aliases: value, fast and name_only mean speed; auto means balance.

Vendor isolation: routing.only and routing.ignore limit which vendors a path may use. An unknown provider returns 400 unknown_provider. A routing.max_provider_credits below the path price returns max_credits_reached before anything runs (0 credits).

What comes back

Section titled “What comes back”
Layer Fields Use
Control es_decision, answer.outcome, answer.confidence Whether to stamp.
Answer result.linkedin_url, result.linkedin_slug The values.
Evidence result.candidates, result.confidence, result.flags, result.source Humans and logs.
Billing usage.credits, usage.hops What ran and what was billed.

result.linkedin_url is always the canonical https://www.linkedin.com/in/<slug>; regional hosts such as de.linkedin.com are normalized. result.candidates lists every profile URL the sources returned, winner first, each with agrees. result.person is the matched profile on a hit and null otherwise: a miss is never a free lookup.

Outcomes:

Result answer.outcome / reason es_decision Credits
A profile URL at or above your floor found hit path price
Below your confidence floor not_found / below_min_confidence miss 0
Nothing found not_found / zero_hits miss 0
Only someone else’s profile not_found / person_mismatch miss 0

Stamp rule: confidence is the only write signal. Write the URL on a billed found answer when answer.confidence meets your floor and neither conflicting_profiles nor unconfirmed_identity is flagged.

Confidence: two independent sources agreeing on the same profile give high. One source gives medium. Sources that disagree give the best guess at low, flagged conflicting_profiles.

Confidence floors: speed defaults to low, balance to medium, accuracy to high. Send min_confidence (high, medium or low) to override. Below the floor linkedin_url comes back blank, the confidence and candidates stay, and the call costs 0. In practice accuracy only delivers when two sources agree.

Flags

Section titled “Flags”
Flag Meaning
conflicting_profiles Sources returned different profiles. Do not stamp.
person_mismatch A source returned someone else’s profile, which was rejected.
unconfirmed_identity You sent a name but the profile carries none. Never high. Do not stamp.
single_source One source answered.

Cache

Section titled “Cache”

Answers are cached for 30 days. The cache key includes the path, linkedin_url, first_name / last_name, min_confidence and routing.only / ignore. A repeat call replays with usage.cached: true at 0 credits.

To force a fresh run, send one of:

  • skip_cache: true;
  • X-Router-Cache: bypass;
  • Cache-Control: no-cache.

DELETE /v1/subjects/email:<address> or li:<slug> erases cached answers.

Errors

Section titled “Errors”

400 validation_failed with one of these reasons:

  • email_required
  • invalid_linkedin_url
  • min_confidence

Also 400 invalid_routing and 400 unknown_provider. A person who asked not to be looked up returns 451 subject_suppressed at 0 credits; do not retry. Business misses stay HTTP 200.