Tool

List creator posts

Use to see one creator's recent posts with each post's outlier score (views / the creator's usual views; 2 or more is an outlier), virality score and engagement rate. Each successful request retrieves the latest posts for 5 credits, including repeated requests.

POSTtools.read5 credits

POST/openapi/v1/tools/list_posts

Call it

curl -X POST https://api.cuekoo.com/openapi/v1/tools/list_posts \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"account":"@creator"}'

The MCP tool is named cuekoo_list_posts. Arguments and results are identical to the REST call.

Arguments

Send a JSON object with these fields. Scope: tools.read.

Name	Type	Required
`account`	`string`	Required
`days`	`integer`	Optional
`platform`	`string`	Optional

Response

Name	Type	Required
`account`	`object`	Required
`account.followers`	`integer`	Required
`account.handle`	`string`	Required
`account.platform`	`string`	Required
`charged`	`boolean`	Required
`items`	`object[] \| null`	Required
`items[].engagement_rate`	`number \| null`	Required
`items[].is_outlier`	`boolean`	Required
`items[].outlier_score`	`number \| null`	Required
`items[].post`	`object`	Required
`items[].post.caption`	`string`	Required
`items[].post.format`	`string`	Required
`items[].post.metrics`	`object`	Required
`items[].post.observed_at`	`string`	Required
`items[].post.platform`	`string`	Required
`items[].post.post_id`	`string`	Required
`items[].post.published_at`	`string`	Required
`items[].post.url`	`string`	Required
`items[].virality_score`	`number \| null`	Required

A call returns the Tool's output object at HTTP 200. Failures use the error envelope.

Credits

5 credits

How credits work