Skip to main content

​
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

NameRequiredTypeNotes
company_urlConditionallystringPublic http(s) company URL. Provide at least one of company_url or target_audience.
target_audienceConditionallystringFree-form audience description. Provide at least one of company_url or target_audience.
pageNointegerDefaults to 1.
pageSizeNointegerDefaults to 20; maximum 100.

​
Response example

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

​
Error responses

  • 400 Bad Request
  • 401 Unauthorized

​
Notes

  • This endpoint accepts profile-style search inputs rather than a simple keyword-only query.
  • No matches return an empty paginated success response (201) rather than 404 Not Found.
  • company_url is reduced to its hostname with leading www. removed before runtime matching.
  • If both company_url and target_audience are provided, target_audience drives the company-name search string while the extracted domain is still applied as an exact filter.
  • matched_event_ids is currently returned as an empty array for this route.
  • techStacks is always returned as an array; when no data is available, the API returns techStacks: [].
  • categories is an optional string array of exhibitor business categories. It is omitted when empty.
  • If you need deduplicated event results directly from a company name, use POST /external/exhibitors/search-events.