Tool

Save to Inspo

Save another creator's TikTok, Instagram or YouTube post to the workspace's Inspo with its numbers frozen as of today. A post id from Discover or list_outliers saves free from stored data; a post_url is fetched fresh and costs 2 credits, charged only when the fetch succeeds (an invalid, private or deleted post is free). A duplicate recognized before fetching is free. A short link resolved by a successful fetch can still cost 2. A workspace keeps at most 1,000 posts.

POSTtools.write0 from storage; 2 credits for a successful fetch

POST/openapi/v1/tools/save_inspo

Call it

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

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

Arguments

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

Name	Type	Required	Description
`collection_id`	`string`	Optional	The collection to file the post in
`post_id`	`string`	Optional	A post id from Discover, list_outliers; saved free from stored data
`post_url`	`string`	Optional	A TikTok, Instagram or YouTube post link; fetched fresh, so it costs credits
`source`	`discover \| competitors \| analyze \| koo \| link \| api \| idea`	Optional	Where the save started: discover, competitors, analyze, koo, link, api or ideaOne of: discover, competitors, analyze, koo, link, api, idea

Response

Name	Type	Required	Description
`credits_charged`	`integer`	Required
`post`	`object`	Required
`post.caption`	`string`	Required
`post.collection_id`	`string \| null`	Required
`post.comments`	`integer \| null`	Required
`post.cover_url`	`string`	Required
`post.creator_handle`	`string`	Required
`post.id`	`string`	Required
`post.likes`	`integer \| null`	Required
`post.outlier_score`	`number \| null`	Required
`post.platform`	`string`	Required
`post.pool_post_id`	`string \| null`	Required
`post.post_id`	`string`	Required
`post.published_at`	`string \| null`	Required
`post.saved_at`	`string`	Required
`post.source`	`string`	Required
`post.url`	`string`	Required
`post.views`	`integer \| null`	Required	At save; never refreshed
`status`	`string`	Required	saved or already_saved

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

Credits

0 from storage; 2 credits for a successful fetch

How credits work