---
title: "Api Activities Object Interactions Filtered"
method: POST
path: "/api/activities/object-interactions/"
tags: ["activities"]
---

# Api Activities Object Interactions Filtered

`POST /api/activities/object-interactions/`

List object-interaction aggregates with complex filtering via POST body (POST-for-filtering — NOT a create). Scalar params stay in the query string exactly as on GET; the response is identical to the equivalent GET.

## Query parameters

- `date` string, date
- `end_time` string, date-time
- `feature_type` string
- `page` integer
- `page_size` integer
- `sort_by` '-interaction_count' | '-last_interaction_at'
- `start_time` string, date-time
- `summary_type` string
- `timezone_offset` number, double

## Headers

- `Authorization` string, required

## Request body

- ActivityFilterRequestRequest — Request body for POST-for-filtering activity endpoints.
  - `filters` object — Filter parameters keyed by field name.

## Response `200`

- PaginatedObjectInteractionList
  - `count` integer, required
  - `next` string, uri, nullable
  - `previous` string, uri, nullable
  - `total_count` integer
  - `current_filters` FilterParamDictPydantic — Pydantic model for FilterParamDict. A dictionary that maps metric names to their filter parameters. Each key is a metric name (str), and each value can be: - A single MetricFilterParamPydantic (one condition) - A List[MetricFilterParamPydantic] (multiple conditions for same metric) - A FilterBundlePydantic (nested filter bundle with connector) Note: Uses extra="allow" for dynamic metric name fields. The __pydantic_extra__ annotation tells Pydantic what types to expect for extra fields, and generates typed additionalProperties in JSON Schema.
  - `filters_data` PaginatedObjectInteractionListFiltersData
  - `results` ObjectInteraction[], required
    - `feature_type` string, required — The resource kind (datasets, prompts, ...).
    - `object_id` string, required — The resource's id (dataset id, prompt_id, ...).
    - `name` string, nullable — Display name of the resource; null when it no longer exists.
    - `interaction_count` integer, required — Recorded interactions for the object (count(id) on ch_activity_event).
    - `last_interaction_at` string, date-time, nullable, required — Timestamp of the most recent interaction, or null.

---

[API](https://skmtc.net/keywordsai/apis/api-reference.md) · [All operations](https://skmtc.net/keywordsai/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/keywordsai/api-reference/versions/c26d550029f8/schema)