Retrieve all interactions (likes and comments) for posts in a specific watchlist. Use this endpoint to analyze engagement activity, build custom reports, or power internal dashboards.Documentation Index
Fetch the complete documentation index at: https://www.outx.ai/docs/llms.txt
Use this file to discover all available pages before exploring further.
Query Parameters
Watchlist ID to retrieve interactions from. This parameter is required and must be a single watchlist ID.
Filter by interaction type. Options:
likecomment
Optional filter for specific actors involved in the interaction. This can include:
- OutX user IDs (for users who liked/commented)
- Author IDs
- Company IDs
- A single ID string
- Multiple values as a comma-separated string
- Multiple values as repeated query params (e.g.,
actor_ids=id1&actor_ids=id2)
Page number for pagination (1-indexed).
Number of interactions per page. Maximum: 100. Values above 100 fall
back to the default.
Array of interaction objects, each containing interaction details and the associated post.
Pagination metadata including current page, page size, total interactions, and totals by interaction type.
Time-series data for the last 7 days, aggregating like and comment counts per day.
Interaction Object Fields
Unique interaction identifier.
Text content of the interaction (for comments).
Type of interaction. One of:
like, comment.Interaction timestamp in milliseconds since epoch.
JSON object describing the interaction author (user or company).
Embedded post object with the same structure as the Posts API.
Error Responses
| Status Code | Error Message | Description |
|---|---|---|
| 400 | watchlist_id is required and must be a string | Missing or invalid watchlist_id parameter |
| 400 | Invalid watchlist ID: <id> | The provided watchlist_id does not exist |
| 401 | Missing API Key / Invalid API Key | API key is missing or incorrect |
| 403 | Access denied: You don’t have permission to access this watchlist | The watchlist belongs to a different team |
| 500 | Failed to fetch interactions | Internal server error |

