Skip to content

index.mdx

Latest commit

 

History

History
109 lines (86 loc) · 6.13 KB

index.mdx

File metadata and controls

109 lines (86 loc) · 6.13 KB
Raw
title Lensmor API Documentation
description Build event and attendee intelligence workflows with trade show discovery, Exhibitor and Social Signals data, registered Visitor access, and contact enrichment.

Build event and attendee intelligence workflows with the Lensmor API. Use it to discover trade shows, evaluate event fit, inspect exhibitors and attendee source types, access registered Visitor data when available, and unlock contact details when your team is ready to act.

Use this documentation to authenticate, make your first request, and integrate Lensmor event, exhibitor, personnel, contact, and recommendation resources into your own workflows.

Current documentation version: v0.25.0

Base URL

https://platform.lensmor.com

All endpoint paths in this documentation are relative to this base URL. For example, GET /external/events/list resolves to GET https://platform.lensmor.com/external/events/list.

Get an API key

Create an account at app.lensmor.com, upgrade to a paid subscription plan, then create a user API key from Settings → API Keys.

Use the key with the API base URL above:

Authorization: Bearer sk_your_api_key

What you can build

Search, filter, and rank trade shows by geography, category, quality, and profile fit. Match target accounts or buyer profiles against exhibitor data and related event presence. Distinguish Exhibitor, Social Signals, and registered Visitor records while preserving people with multiple source labels. Move from preview results to base event coverage, registered Visitor access, or both in one atomic action. Start asynchronous email unlock jobs and poll task status until contact data is ready.

Which endpoint should I use?

If you have... Start with Why
A keyword, geography, or date range Events list Broad event catalog search.
A company website or buyer profile Apply profile and get recommended events Returns ranked events from profile context.
A known event ID Exhibitors list or Personnel list Shows event-scoped companies and people; personnel records can include Exhibitor, Social Signals, and Visitor source labels.
An event that needs both base and visitor access Unlock full event access Prechecks and atomically unlocks missing access layers for up to 5000 credits.
A company name and you want companies Exhibitor company search Precision-first company lookup. Non-empty results cost 50 credits.
A company name and you want events Exhibitor event search Finds events associated with that company. Non-empty results cost 50 credits.
Personnel IDs and you need emails Unlock contact emails Starts an async email unlock task.

Recommended integration path

Create a user API key and send it as `Authorization: Bearer sk_your_api_key`. Call `GET /external/credits/balance` and the relevant action precheck before event, visitor, email, or reverse-search workflows. Use Events, Exhibitors, Personnel, Contacts, or Profile Matching endpoints depending on your workflow. Treat `sourceType` as a multi-value array and keep event-scoped labels separate from source labels aggregated across a person's related events. Read `semantics` metadata, handle `402 Payment Required`, and back off on `429 Too Many Requests`.

First request

curl "https://platform.lensmor.com/external/events/list?page=1&pageSize=20" \
  -H "Authorization: Bearer $LENSMOR_API_KEY"

If the request succeeds, continue with the Quickstart guide. If it fails, check Authentication and Error conventions.

Available resources

  • Credits — inspect the API key owner's current credit balance.
  • Events — browse, score, rank, inspect event details, and unlock base or visitor access.
  • Exhibitors — list exhibitors, search by company context, inspect profiles, and fetch related events.
  • Personnel — list people, interpret attendee source labels, inspect profiles, and fetch related events.
  • Contacts — search contacts, unlock emails, and poll unlock tasks.
  • Profile Matching — apply profile inputs and retrieve recommended events or exhibitors.

Shared conventions

Stay current

Review the Changelog for newly documented endpoints, behavior clarifications, and machine-readable resource updates.

If your integration needs a workflow that is not covered here, contact Lensmor support.