crate.searchEvents.refined(body)
refined(body: RefinedBeaconInput, opts: RequestOptions & { beaconToken: string }): Promise<void>Report a refined search — which facets changed (from → to) — so crate learns how people narrow results.
| Endpoint | POST /api/v2/search-events/refined |
| Auth | beacon |
| Returns | void |
| Retryable | no |
| Idempotent | no |
Example
Section titled “Example”await crate.searchEvents.refined( { search_event_id: id, changed_facets: [{ name: 'genre', to: 'idm' }] }, { beaconToken },);Throws
Section titled “Throws”beacon_token_required— whenbeaconTokenis missing.