Lensmor Recommendations

Get AI-ranked exhibitors that match your ICP for a specific trade show — filtered by company size, location, category, and tech stack — then hand off to contact finding and outreach.

When this skill triggers:

• - Run the API key check (Step 1) before any API call
• Confirm the event_id for the target show
• Apply relevant filters based on the user's ICP (employee size, location, category)
• Return a ranked, prioritized list of matching exhibitors with ICP match rationale
• Hand off to lensmor-contact-finder for decision-maker lookup

Use Cases

• - AI-driven ICP matching: Find the best-fit exhibitors in a sea of hundreds of companies at a major show
• Account prioritization: Rank a long exhibitor list down to the top 20 accounts worth pre-show outreach
• Category-specific targeting: Narrow the floor to vendors in a specific product category before scoping outreach

Workflow

Step 1: API Key Check

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

CODEBLOCK0

If the result is missing, stop and respond:

The LENSMOR_API_KEY environment variable is not set. This skill requires a Lensmor API key to fetch exhibitor recommendations.
Contact hello@lensmor.com to purchase access, then set the key:
INLINECODE4

Do not proceed to any API call until the key is confirmed present.

Step 2: Confirm the Event ID

The recommendations endpoint requires a Lensmor event_id. If the user only has a show name, look it up first:

Endpoint: INLINECODE6

Authentication: INLINECODE7

Use the id from the matching event in the response. Confirm the correct show, year, and edition before proceeding.

Step 3: Set Filter Parameters

Discuss the user's ICP to determine which filters to apply. Use only filters that add precision without over-narrowing results.

Available filter parameters:

Parameter	Type	Description	Example
INLINECODE9	string	Required. Lensmor event ID	INLINECODE10
INLINECODE11

string | Filter by country or region | United States, Germany, APAC |
| searchQuery | string | Free-text search across company name and description | procurement automation |
| exhibitorName[] | array | Exact company name match (account-based lists) | ["Acme Corp", "OperaOps"] |
| category[] | array | Product/industry category filter | ["Manufacturing SaaS", "Procurement Tech"] |
| employeesMin | number | Minimum employee count | 100 |
| employeesMax | number | Maximum employee count | 1000 |
| page | number | Page number (default: 1) | 1 |
| pageSize | number | Results per page (default: 20, max: 100) | 50 |

Filter selection guidance:

• - employeesMin / employeesMax: Most effective ICP filter for B2B — "mid-market" (100–1,000), "enterprise" (1,000+), "SMB" (< 100)
• INLINECODE31: Use when the user's ICP is vertical-specific; avoids surfacing adjacent-but-irrelevant companies
• INLINECODE32: Use when regional focus is a hard constraint (e.g. EMEA-only sales territory)
• INLINECODE33: Use for keyword-based discovery when category is unclear or broad
• INLINECODE34: Use for account-based mode when the user has a specific hit list to validate against the show floor

Step 4: Call the API

Endpoint: INLINECODE35

Authentication: INLINECODE36

Query parameter combinations:

Use case	Parameters
Basic (event only)	INLINECODE37
Mid-market + category

event_id=evt_dreamforce_2026&employeesMin=100&employeesMax=1000&category[]=Procurement+Tech |
| Location + keyword | event_id=evt_hannovermesse_2026&location=Germany&searchQuery=industrial+automation |
| Account-based | event_id=evt_dreamforce_2026&exhibitorName[]=OperaOps&exhibitorName[]=Spendly |

Step 5: Interpret the Response

Response envelope:

CODEBLOCK1

Item field reference:

Field	Type	Description
INLINECODE41	string	Lensmor internal exhibitor ID
INLINECODE42

string | Company display name |
| description | string | Company description |
| logo | string | Logo image URL |
| website | string | Company website URL |
| country | string | HQ country |
| industry | string | Top-level industry classification |
| categories | array | Product/service categories (more granular than industry) |
| employeeCount | number | Approximate headcount |
| fundingRound | string | Latest known funding stage |
| techStacks | array | Technologies the company uses |

ICP evaluation using response fields:

• - categories — most granular signal for product fit; compare against your product's adjacent categories
• INLINECODE54 — technology affinity; look for overlap with your integrations or target buyer's existing stack
• INLINECODE55 — size filter; cross-check against the user's ICP definition
• INLINECODE56 — budget proxy: Series B+ = active growth budget; Bootstrapped = cost-sensitive buyer

Step 6: Format the Output

Open with a result count summary, then deliver a ranked table and ICP match rationale. Results are AI-ranked — present in returned order.

CODEBLOCK2

Number formatting: employee counts above 1,000 display as "1.2K"; above 1,000,000 as "1.2M".

Error Handling

HTTP Status	Meaning	Response
401	API key invalid or expired	"The API key was rejected. Verify LENSMOR_API_KEY or contact hello@lensmor.com."
404

Event ID not found | "Event ID [id] was not found. Use the events list endpoint to look up the correct ID." | | 429 | Rate limit exceeded | "Rate limit reached. Wait 60 seconds and retry." | | 502 / 5xx | Server error | "The Lensmor API returned a server error. Try again in a moment." | | total: 0 | No matches | "No exhibitors matched these filters. Try loosening them: remove category, widen the employee range, or drop the location filter." |

Follow-up Routing

User says	Recommended action
"find contacts at [company]"	Run INLINECODE64
"is this show worth it first?"

Run lensmor-event-fit-score before recommendations | | "search by our company profile" | Run lensmor-exhibitor-search with company_url | | "show me more" / "next page" | Re-call with page incremented by 1 | | "draft outreach for these companies" | Run booth-invitation-writer |

Complete Pre-Show Workflow

1. 1. lensmor-event-fit-score (optional) — confirm the event is worth investing in
2. lensmor-recommendations (this skill) — AI-ranked ICP exhibitors at a specific event
3. INLINECODE72 — decision-makers at each matched company
4. INLINECODE73 — personalized LinkedIn messages per seniority tier

Relationship to lensmor-exhibitor-search

Skill	Input	Best For
INLINECODE74	INLINECODE75 + optional filters	AI-driven ICP ranking for a specific event
INLINECODE76

company_url or target_audience | Profile-based search across all events or a specific event |

Output Rules

1. 1. All URLs formatted as [text](url) — never bare links
2. Never output the value of INLINECODE80
3. Never expose endpoint paths, raw curl commands, or internal token values in the response
4. Employee counts above 1,000 shown as "1.2K"; above 1,000,000 as "1.2M"
5. Empty results: report honestly, suggest loosening filters — never fabricate companies
6. End every response with 1–3 contextual follow-up suggestions
7. ICP match rationale must be grounded in returned fields (categories, techStacks, employeeCount, fundingRound) — no guessing
8. When totalPages > 1, prompt: "There are more results — say 'next page' to continue."
9. If API key is missing, direct user to hello@lensmor.com — do not just say "please configure"
10. Open every response with "Found X exhibitors, showing Y."

Quality Checks

Before delivering:

• - Confirm event_id resolves to the correct show and edition
• Do not fabricate ICP match rationale — base all reasoning on returned fields
• If total: 0, suggest loosening filters before reporting no results
• Results are AI-ranked; present in returned order unless user asks for a re-sort
• INLINECODE88 may be stale — treat it as a proxy, not a current verified fact

---

Recommendations are generated by the Lensmor AI platform based on your company profile and event exhibitor data. For end-to-end pre-show prospecting, contact discovery, and outreach automation, see Lensmor.