Apply profile and get recommended events
Apply company-profile inputs synchronously and return a paginated set of Lensmor events ranked for that profile.
Use this endpoint when discovery starts from a company website or target-audience description rather than from a known event. Provide at least one of company_url or target_audience, then optionally narrow results by geography, category, event type, dates, future status, or attendee-count range.
This endpoint does not spend credits or unlock event access. Recommendation scores, tiers, reasons, and matched-exhibitor evidence are point-in-time outputs that can change as the profile or Lensmor data changes. Use neutral event list search when profile-based ranking is not required.
Authorizations
Send the full Business API key from Settings -> API Keys, for example Authorization: Bearer sk_your_api_key.
Body
Provide company-profile context, pagination, and optional event filters for recommendation generation.
- Option 1
- Option 2
Public http(s) company website used as profile context. Provide it or target_audience.
500"https://acme.example"
Free-form ideal-customer or target-audience description. Provide it or company_url.
"Enterprise marketing teams in North America"
One-based result page number.
x >= 11
Maximum records requested per page; defaults to 20 and cannot exceed 100.
1 <= x <= 10020
Override synchronous top-three recommendation-reason generation for this request.
true
Filter recommendations by city.
"Las Vegas"
Filter recommendations by region or state.
"Nevada"
Filter recommendations by country.
"United States"
Filter by category labels. Arrays and comma-separated inputs are normalized.
Filter by Lensmor event-type identifiers.
Inclusive lower bound for event start date in YYYY-MM-DD format.
"2025-01-01"
Inclusive upper bound for event start date in YYYY-MM-DD format.
"2025-12-31"
Future-event flag used by the recommendation filter.
1
Minimum attendee count, inclusive.
x >= 0500
Maximum attendee count, inclusive.
x >= 050000
Optional safe public LinkedIn profile URL used as additional profile context.
500"https://www.linkedin.com/in/jane-doe"
Optional company description used as additional profile-matching context.
2000"We help retailers connect with technology vendors through trade shows and events."
Optional company industry used as profile context.
255"Retail Technology"
Optional target industries used to scope exhibitor recommendations.
255Optional free-text description of events the caller already plans to attend.
500"NRF, Shoptalk, and regional retail trade shows"
Optional management-level labels used for personnel matching.
100Optional job-title or function terms. The runtime normalizes the input and retains the first five non-empty values.
255Optional synchronous processing timeout in milliseconds, from one minute to one hour.
60000 <= x <= 3600000900000
Response
Recommended events
Paginated profile-matched events and recommendation metadata.
Recommended event records for the requested page.
Total matching records across all pages.
One-based page number returned.
Maximum records requested for this page.
Total pages available for the current query.
Whether another result page is available.
Synchronous recommendation outcome: results returned or no matching events found.
completed, completed_empty Condition tags returned as part of this profile event recommendation page object.
Profile version returned as part of this profile event recommendation page object.
Active result version returned as part of this profile event recommendation page object.
Is stale returned as part of this profile event recommendation page object.