Skip to main content

Documentation Index

Fetch the complete documentation index at: https://api.lensmor.com/llms.txt

Use this file to discover all available pages before exploring further.

Exhibitors search

Search exhibitors using company context. Use this endpoint when you want exhibitor results derived from a public company URL, a target audience description, or both.

Endpoint

POST /external/exhibitors/search

Authentication

See Authentication

Success status code

201 Created

Request body

FieldRequiredTypeNotes
company_urlConditionallystringOptional URL; at least one of company_url or target_audience is required.
target_audienceConditionallystringOptional free-text audience string; at least one of company_url or target_audience is required.
pageNointegerDefaults to 1.
pageSizeNointegerDefaults to 20, max 100.

Response body

Top-level fields

FieldTypeNotes
itemsobject[]Same exhibitor summary shape as GET /external/exhibitors/list items[].
totalintegerTotal matched exhibitors.
pageintegerCurrent page number.
pageSizeintegerPage size used for this response.
totalPagesinteger0 when total is 0.
hasMorebooleantrue when another page exists.

Response example

{
  "items": [
    {
      "id": "456",
      "companyName": "Acme",
      "domain": "acme.com",
      "description": null,
      "website": "https://acme.com",
      "industry": "Retail Technology",
      "employeeCount": 120,
      "country": "United States",
      "logo": null,
      "linkedinUrl": null,
      "fundingRound": null,
      "matched_event_ids": [],
      "techStacks": [
        "React"
      ],
      "categories": [
        "Retail"
      ]
    }
  ],
  "total": 1,
  "page": 1,
  "pageSize": 20,
  "totalPages": 1,
  "hasMore": false
}

Error responses

  • 400 Bad Request when neither company_url nor target_audience is provided, or company_url is not a valid URL.
  • 401 Unauthorized when the API key is missing, malformed, or invalid.

Notes

  • No matches return an empty success response rather than 404.
  • matched_event_ids is an empty array when no event scope or match data exists.
  • techStacks is always returned as an array.