Recommended exhibitors for event

Retrieve Lensmor recommended exhibitors for an event with profile match signals, recommendation ranks, tiers, and pagination metadata.

Return recommended exhibitors for a single event.

Use this endpoint when you already know the target event and want exhibitor recommendations under the caller’s current recommendation state.

When to use this endpoint

Use GET /external/profile-matching/recommendations/exhibitors when you want recommended exhibitors for one event, not the neutral event exhibitor catalog.

Choose this endpoint when:

• the user has already selected an event
• your product has profile or recommendation state for the caller
• you want exhibitor results filtered and ordered for relevance

Use Exhibitors list when you need the broader event-scoped exhibitor catalog with preview/full access semantics.

Endpoint

GET /external/profile-matching/recommendations/exhibitors

Authentication

See Authentication

Success status code

200 OK

Query parameters

Name	Required	Type	Notes
event_id	Yes	string	Event identifier.
page	No	integer	Defaults to 1.
pageSize	No	integer	Defaults to 20; maximum 100.
location	No	string[]	Country or region filter. Repeated query parameters are supported.
searchQuery	No	string	Company-name or description search.
exhibitorName	No	string[]	Exact-name filter; repeated query params are normalized into arrays.
category	No	string[]	Category filter.
industry	No	string[]	Industry filter. Repeated query parameters are supported.
employeesMin	No	integer	Minimum employee count.
employeesMax	No	integer	Maximum employee count.

Request example

curl "https://platform.lensmor.com/external/profile-matching/recommendations/exhibitors?event_id=139574&page=1&pageSize=20" \
  -H "Authorization: Bearer $LENSMOR_API_KEY"

Filter recommended exhibitors

curl "https://platform.lensmor.com/external/profile-matching/recommendations/exhibitors?event_id=139574&industry=Retail%20Technology&employeesMin=100&employeesMax=1000&page=1&pageSize=20" \
  -H "Authorization: Bearer $LENSMOR_API_KEY"

Response example

{
  "items": [
    {
      "id": "456",
      "companyName": "Acme Retail Systems",
      "description": "Retail analytics platform",
      "logo": null,
      "website": "https://acme.example",
      "country": "United States",
      "industry": "Retail Technology",
      "categories": ["Retail", "POS"],
      "employeeCount": 220,
      "fundingRound": "Series B",
      "techStacks": ["Cloudflare", "Nginx"]
    }
  ],
  "total": 87,
  "page": 1,
  "pageSize": 20,
  "totalPages": 5,
  "hasMore": true
}

Response fields

Field	Description
items	Recommended exhibitor records.
id	Exhibitor identifier.
companyName, description, website	Display and web presence fields.
country, industry, categories	Classification fields.
employeeCount, fundingRound, techStacks	Enrichment and firmographic signals.
total, page, pageSize, totalPages, hasMore	Pagination metadata.

Filtering behavior

Use filters to narrow recommended exhibitors after recommendation state is established. For exact company-name lookup, use Exhibitor company search.

Error responses

• 400 Bad Request
• 401 Unauthorized
• 404 Not Found
• 429 Too Many Requests

Notes

• Unknown event_id values are normalized to 404 EVENT_NOT_FOUND responses.
• The request parameter event_id refers to the eventId value returned by event endpoints.
• categories is preserved when recommendation data contains category labels.
• techStacks is always returned as an array; when no data is available, the API returns techStacks: [].