Skip to main content
POST
Apply profile and get recommended events

Authorizations

Authorization
string
header
required

Send the full Business API key from Settings -> API Keys, for example Authorization: Bearer sk_your_api_key.

Body

application/json

Provide company-profile context, pagination, and optional event filters for recommendation generation.

company_url
string<uri>
required

Public http(s) company website used as profile context. Provide it or target_audience.

Maximum string length: 500
Example:

"https://acme.example"

target_audience
string

Free-form ideal-customer or target-audience description. Provide it or company_url.

Example:

"Enterprise marketing teams in North America"

page
integer
default:1

One-based result page number.

Required range: x >= 1
Example:

1

pageSize
integer
default:20

Maximum records requested per page; defaults to 20 and cannot exceed 100.

Required range: 1 <= x <= 100
Example:

20

autoRecommendTop3EventsEnabled
boolean

Override synchronous top-three recommendation-reason generation for this request.

Example:

true

city
string

Filter recommendations by city.

Example:

"Las Vegas"

region
string

Filter recommendations by region or state.

Example:

"Nevada"

country
string

Filter recommendations by country.

Example:

"United States"

category
string[]

Filter by category labels. Arrays and comma-separated inputs are normalized.

Example:
eventTypeIds
integer[]

Filter by Lensmor event-type identifiers.

Example:
dateStartFrom
string<date>

Inclusive lower bound for event start date in YYYY-MM-DD format.

Example:

"2025-01-01"

dateStartTo
string<date>

Inclusive upper bound for event start date in YYYY-MM-DD format.

Example:

"2025-12-31"

future
integer

Future-event flag used by the recommendation filter.

Example:

1

attendeeCountMin
integer

Minimum attendee count, inclusive.

Required range: x >= 0
Example:

500

attendeeCountMax
integer

Maximum attendee count, inclusive.

Required range: x >= 0
Example:

50000

linkedin_url
string<uri>

Optional safe public LinkedIn profile URL used as additional profile context.

Maximum string length: 500
Example:

"https://www.linkedin.com/in/jane-doe"

company_description
string

Optional company description used as additional profile-matching context.

Maximum string length: 2000
Example:

"We help retailers connect with technology vendors through trade shows and events."

industry
string

Optional company industry used as profile context.

Maximum string length: 255
Example:

"Retail Technology"

target_industry
string[]

Optional target industries used to scope exhibitor recommendations.

Maximum string length: 255
Example:
planned_events
string

Optional free-text description of events the caller already plans to attend.

Maximum string length: 500
Example:

"NRF, Shoptalk, and regional retail trade shows"

target_management_level
string[]

Optional management-level labels used for personnel matching.

Maximum string length: 100
Example:
target_job_titles
string[]

Optional job-title or function terms. The runtime normalizes the input and retains the first five non-empty values.

Maximum string length: 255
Example:
timeout_ms
integer

Optional synchronous processing timeout in milliseconds, from one minute to one hour.

Required range: 60000 <= x <= 3600000
Example:

900000

Response

Recommended events

Paginated profile-matched events and recommendation metadata.

items
object[]
required

Recommended event records for the requested page.

total
integer
required

Total matching records across all pages.

page
integer
required

One-based page number returned.

pageSize
integer
required

Maximum records requested for this page.

totalPages
integer
required

Total pages available for the current query.

hasMore
boolean
required

Whether another result page is available.

status
enum<string>
required

Synchronous recommendation outcome: results returned or no matching events found.

Available options:
completed,
completed_empty
condition_tags
object
required

Condition tags returned as part of this profile event recommendation page object.

profile_version
integer | null
required

Profile version returned as part of this profile event recommendation page object.

active_result_version
integer | null
required

Active result version returned as part of this profile event recommendation page object.

is_stale
boolean
required

Is stale returned as part of this profile event recommendation page object.