> For the complete documentation index, see [llms.txt](https://docs.getlimy.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.getlimy.ai/rest-api/api-reference/traffic.md).

# Traffic

## Export captured actions

> Returns AI-referred events captured on your domain — any event type (page views, autocapture, custom) — each with its AI referrer (\`ai\_provider\`) and the raw captured properties. \*\*Beta:\*\* the response shape may change.

```json
{"openapi":"3.0.0","info":{"title":"Limy API","version":"1.0"},"tags":[{"name":"traffic"}],"security":[{"bearer":[]}],"components":{"securitySchemes":{"bearer":{"scheme":"bearer","bearerFormat":"JWT","type":"http"}},"schemas":{"CapturedActionsRequestDto":{"type":"object","properties":{"filters":{"type":"object","properties":{"timeRange":{"type":"object","properties":{"from":{"type":"string","format":"date-time","description":"Start of the export window (inclusive), ISO 8601 date-time."},"to":{"type":"string","format":"date-time","description":"End of the export window (exclusive), ISO 8601 date-time."}},"required":["from","to"]},"userIds":{"description":"Optional list of visitor IDs (distinctId) to filter by. Omit to return all visitors.","type":"array","items":{"type":"string"}}},"required":["timeRange"]},"limit":{"default":200,"description":"Maximum number of events to return per page (1–1000).","type":"integer","exclusiveMinimum":true,"maximum":1000,"minimum":0},"cursor":{"description":"Opaque keyset cursor from a previous response. Pass `pagination.nextCursor` to fetch the next page; omit for the first page.","type":"string"}},"required":["filters"]},"CapturedActionsResponseDto":{"type":"object","properties":{"actions":{"type":"array","items":{"type":"object","properties":{"uuid":{"type":"string"},"event":{"type":"string"},"timestamp":{"type":"string"},"team_id":{"type":"number"},"distinct_id":{"type":"string","description":"Stable visitor identifier. This is the value matched by the `filters.userIds` request filter."},"elements_chain":{"type":"string"},"created_at":{"type":"string"},"person_id":{"type":"string"},"person_created_at":{"type":"string"},"person_properties":{"type":"string"},"person_mode":{"type":"string"},"_timestamp":{"type":"string"},"inserted_at":{"type":"string","nullable":true},"ai_provider":{"type":"string","description":"AI engine that referred the visit (e.g. ChatGPT, Gemini, Perplexity). Only AI-referred events are returned."}},"required":["uuid","event","timestamp","team_id","distinct_id","elements_chain","created_at","person_id","person_created_at","person_properties","person_mode","_timestamp","inserted_at","ai_provider"],"additionalProperties":{}}},"pagination":{"type":"object","properties":{"nextCursor":{"type":"string","nullable":true},"hasMore":{"type":"boolean"}},"required":["nextCursor","hasMore"]}},"required":["actions","pagination"]}}},"paths":{"/v1/traffic/sdk/captured-actions":{"post":{"description":"Returns AI-referred events captured on your domain — any event type (page views, autocapture, custom) — each with its AI referrer (`ai_provider`) and the raw captured properties. **Beta:** the response shape may change.","operationId":"SdkTrafficController_getCapturedActions","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CapturedActionsRequestDto"}}}},"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CapturedActionsResponseDto"}}}}},"summary":"Export captured actions","tags":["traffic"]}}}}
```