LEleadmagic
People Enrichment

People Search

Changed on

Find professional profiles by company, title, role, seniority, and recorded profile attributes. Choose a person before requesting Email Finder or Mobile Finder separately. Search does not expose contact values or availability indicators.

post/v3/people/search

Request

  • Base URL
    https://api.leadmagic.io
  • Auth
    API key in header X-API-Key

Request body

company_domainstring
company_namestring
linkedin_urlstring

B2B company profile URL or slug.

company_filtersobject

Employer criteria supported by People Search: identity, industry, classification, headcount, revenue, founding year, headquarters, funding, and technology. tech_stack and each *_tech criterion accept at most 50 values and require every requested technology; more values match no records. This is a subset of standalone Company Search. Unsupported selected keys are listed in ignored_filters with warnings; accepted input does not guarantee application.

people_filtersobject

Current professional-profile filters for name, title/function/level, persona, residence and job geography, profile identity, headline/about-me/description, recorded industry, language, seniority, job count, and connections. Residence, job location, and company headquarters are distinct filters and AND together. Freeform location/contact_location accepts at most five comma-separated terms; more terms match no records. This limit does not apply to explicit geography arrays. contact_job_function accepts short chips such as Sales or full standard department labels; contact_job_level selects exact levels. Role flags are stored title/function heuristics and can be incomplete or misclassified; they do not verify buying authority. Prefer contact_job_function and explicit titles for precise roles. min_seniority is an inclusive 0-5 role-rank floor (0 Other/unclassified, 1 Staff, 2 Manager, 3 Director, 4 VP, 5 C-Team), not buying-authority confidence. contact_persona matches literal label text ignoring case. Multiple values in the same supported text/enum array are OR'd; different filter keys are AND'd. Numeric bounds are inclusive. Prior-title history and follower counts are unavailable. Contact details are obtained through separate Email Finder or Mobile Finder requests. Selected criteria the current search cannot apply appear in top-level ignored_filters and warnings.

titlestring
job_titlestring
titlesstring[]
rolesstring[]
querystring

Free-text people/title query.

include_companyboolean
confirm_credit_chargeboolean

Accepted for backwards compatibility; not required and does not enable contact values in search.

limitinteger

Offset requests allow up to 10000 rows; cursor-based pages are capped at 50.

cursorstring

Opaque signed next_cursor from the previous page. Send unchanged with the same filters, a limit no greater than 50, and offset 0.

offsetinteger

Legacy offset pagination; prefer cursor. Unstable ordering, uncached. Restart at offset 0 to obtain a cursor.

Example request

{
  "company_domain": "leadmagic.io",
  "company_name": "LeadMagic",
  "linkedin_url": "https://www.linkedin.com/company/acme/",
  "title": "VP Sales",
  "job_title": "Head of Revenue"
}

Response

People search results

messagestring
credits_consumednumber

Finalized search credits; 1 per returned person on metered plans, or 0 for eligible included-plan searches. Separate enrichment requests are charged independently.

credit_previewobject
companiesobject[]
countinteger

Number of people returned in this page, not total audience size.

returned_countinteger

Number of people returned in this page.

ignored_filtersstring[]

Qualified keys of selected criteria that were not applied.

warningsstring[]

Explanations of unavailable or unapplied criteria.

limit_appliedinteger
offsetinteger
has_moreboolean
next_cursorstring nullable

Opaque signed token for the next page, or null on the last page. Send back as cursor with offset 0. Cursor pagination is stable and cached.

Changes

  • 73ee3c7d32f2Revision changes
    • warning

      removed the request property

    • warning

      removed the request property

    • warning

      removed the request property

    • warning

      removed the request property

    • warning

      removed the request property

    • warning

      removed the request property

    • warning

      removed the request property

    • warning

      removed the request property

    • warning

      removed the optional property // from the response with the status

    • warning

      removed the optional property // from the response with the status

    • warning

      removed the optional property // from the response with the status

    • warning

      removed the optional property // from the response with the status

    • warning

      removed the optional property // from the response with the status

    • warning

      removed the optional property // from the response with the status

    • warning

      removed the optional property // from the response with the status

    • warning

      removed the optional property // from the response with the status

    • warning

      removed the optional property // from the response with the status

    • warning

      removed the optional property // from the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

  • a3770169579bRevision changes
    • breaking

      request property was restricted to a list of enum values

    • breaking

      request property was restricted to a list of enum values

    • breaking

      request property was restricted to a list of enum values

    • breaking

      the // response's property type changed from string to null for status

    • breaking

      the // response's property type changed from string to null for status

    • breaking

      the // response's property type changed from string to null for status

    • breaking

      the // response's property type changed from string to null for status

    • info

      the request property default value false was added

    • info

      the request property default value false was added

    • info

      added the new false enum value to the request property

    • info

      added the new false enum value to the request property

    • info

      added the new false enum value to the request property