trade-show-exhibitor-search

Lensmor Exhibitor Search

Use the Lensmor API in one of two explicit modes:

• Event-specific list — list and filter companies recorded for one event
• Cross-event discovery — search the wider exhibitor dataset from a company URL or target-audience phrase

Do not mix the two contracts. POST /external/exhibitors/search does not accept event_id.

Example Requests

• Who is exhibiting at this show?
• 参展商搜索
• Aussteller finden
• 出展社を探す
• buscar expositores

Request Handling

• Every Lensmor request, including event lookup and pagination, must send Authorization: Bearer $LENSMOR_API_KEY. Send the key only to https://platform.lensmor.com; never include it in URLs, output, or requests to company/event websites.
• Use a 10-second connection timeout and 30-second request timeout. Inspect the HTTP status before interpreting JSON; a non-2xx response, malformed JSON, or missing required response fields is a failed request, not an empty result or a zero score.
• Start with one page (page=1, pageSize at most 100). Preserve filters across pages and disclose partial coverage. Do not fetch every page automatically.
• For a read-only GET, allow at most one retry after a 429 or temporary 5xx, respecting Retry-After; if the delay is unavailable or impractical, report the failure and stop. Do not retry a POST automatically. A timeout may leave its outcome unknown, especially for a charged search.
• If event lookup returns multiple editions, ask for the intended year/edition before continuing. Use the resolved event ID, never a sample ID from this document.

Workflow

Step 1: API Key Check

Before making any API call, verify the key is configured:

[ -n "${LENSMOR_API_KEY:-}" ] && echo "ok" || echo "missing"

If missing, stop and tell the user to obtain a key from Lensmor, then set:

export LENSMOR_API_KEY=your_key_here

Never print the key value.

Step 2: Choose the Mode

Use event-specific list when the user names a show, supplies an event_id, or asks who is exhibiting at an event.