Tool

Get post

Use to inspect one post's metrics, its outlier score (views / its creator's usual views; 2 or more is an outlier), virality score and engagement rate. API and MCP lookups of third-party posts cost 2 credits, even on a cache hit. Page reads of fresh saved metrics are free; a live refresh costs 2.

POSTtools.read2 credits

POST/openapi/v1/tools/get_post

Call it

curl -X POST https://api.cuekoo.com/openapi/v1/tools/get_post \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://www.tiktok.com/@creator/video/123"}'

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

Arguments

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

Name	Type	Required
`url`	`string`	Required

Response

Name	Type	Required
`charged`	`boolean`	Required
`engagement_rate`	`number \| null`	Required
`is_outlier`	`boolean`	Required
`outlier_score`	`number \| null`	Required
`post`	`object`	Required
`post.caption`	`string`	Required
`post.format`	`string`	Required
`post.metrics`	`object`	Required
`post.metrics.comments`	`integer \| null`	Required
`post.metrics.likes`	`integer \| null`	Required
`post.metrics.saves`	`integer \| null`	Required
`post.metrics.shares`	`integer \| null`	Required
`post.metrics.views`	`integer \| null`	Required
`post.observed_at`	`string`	Required
`post.platform`	`string`	Required
`post.post_id`	`string`	Required
`post.published_at`	`string`	Required
`post.url`	`string`	Required
`virality_score`	`number \| null`	Required

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

Credits

2 credits

How credits work