---
title: "Record privacy-bounded ToolScout embed telemetry"
method: POST
path: "/api/distribution/embed-event"
---

# Record privacy-bounded ToolScout embed telemetry

`POST /api/distribution/embed-event`

## Request

- Base URL: `https://trytoolscout.org`
- URL: `https://trytoolscout.org/api/distribution/embed-event`
- Auth: none declared

Records publisher adoption and widget interaction evidence. Raw Finder search text is not accepted or stored by this telemetry contract.

## Request body

- object
  - `embed_type` 'finder' | 'compare' | 'pick', required
  - `event` string, required
  - `publisher_id` string
  - `publisher_host` string
  - `asset_id` string
  - `intent_slug` string
  - `result_slug` string
  - `result_count` integer
  - `mode` string

## Response `204`

Telemetry accepted

## Other responses

- `400`: Invalid telemetry event
- `503`: Telemetry store temporarily unavailable

---

[API](https://skmtc.dev/trytoolscout/apis/toolscout-software-decision-engine-api.md) · [All operations](https://skmtc.dev/trytoolscout/apis/toolscout-software-decision-engine-api/llms.txt) · [OpenAPI document](https://skmtc.dev/trytoolscout/apis/toolscout-software-decision-engine-api/revisions/6cbcc25159a1?raw)