naftiko: 1.0.0-alpha2 info: label: KonbiniAPI — TikTok description: 'KonbiniAPI — TikTok. 20 operations. Lead operation: Get Audio Details. Self-contained Naftiko capability covering one Konbiniapi business surface.' tags: - Konbiniapi - TikTok created: '2026-05-19' modified: '2026-05-19' binds: - namespace: env keys: KONBINIAPI_API_KEY: KONBINIAPI_API_KEY capability: consumes: - type: http namespace: konbiniapi-tiktok baseUri: https://api.konbiniapi.com description: KonbiniAPI — TikTok business capability. Self-contained, no shared references. resources: - name: v1-tiktok-audios-audioId path: /v1/tiktok/audios/{audioId} operations: - name: tiktokgetaudio method: GET description: Get Audio Details outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: audioId in: path type: string description: TikTok audio/music ID required: true - name: v1-tiktok-audios-audioId-videos path: /v1/tiktok/audios/{audioId}/videos operations: - name: tiktokgetaudiovideos method: GET description: Get Videos with Audio outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: audioId in: path type: string description: TikTok audio/music ID required: true - name: count in: query type: integer description: 'Number of videos to fetch (maximum: 30)' - name: cursor in: query type: string description: Pagination cursor - name: v1-tiktok-collections-collectionId path: /v1/tiktok/collections/{collectionId} operations: - name: tiktokgetcollectionvideos method: GET description: Get Collection Videos outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: collectionId in: path type: string description: TikTok collection ID (mix ID) required: true - name: count in: query type: integer description: 'Number of videos to fetch (maximum: 35)' - name: cursor in: query type: string description: Pagination cursor - name: v1-tiktok-search path: /v1/tiktok/search operations: - name: tiktoksearchcontent method: GET description: Search Content outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: query in: query type: string description: Search query required: true - name: cursor in: query type: string description: Pagination cursor - name: count in: query type: integer description: 'Number of items to fetch (maximum: 100, actual results may vary)' - name: order in: query type: string description: 'Sort order: relevance (default), most-liked, or date-posted' - name: published in: query type: string description: 'Filter by publish time: all-time (default), yesterday, this-week, this-month, last-3-months, or last-6-months' - name: v1-tiktok-search-users path: /v1/tiktok/search/users operations: - name: tiktoksearchusers method: GET description: Search Users outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: query in: query type: string description: Search query required: true - name: count in: query type: integer description: Page size (fixed at 10 by the platform) - name: cursor in: query type: string description: Pagination cursor - name: v1-tiktok-search-videos path: /v1/tiktok/search/videos operations: - name: tiktoksearchvideos method: GET description: Search Videos outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: query in: query type: string description: Search query required: true - name: cursor in: query type: string description: Pagination cursor - name: count in: query type: integer description: 'Number of videos to fetch (maximum: 100, actual results may vary)' - name: order in: query type: string description: 'Sort order: relevance (default), most-liked, or date-posted' - name: published in: query type: string description: 'Filter by publish time: all-time (default), yesterday, this-week, this-month, last-3-months, or last-6-months' - name: v1-tiktok-tags-tagName path: /v1/tiktok/tags/{tagName} operations: - name: tiktokgettagvideos method: GET description: Get Videos with Tag outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: tagName in: path type: string description: Tag name required: true - name: count in: query type: integer description: 'Number of videos to fetch (maximum: 30)' - name: cursor in: query type: string description: Pagination cursor - name: v1-tiktok-users-username path: /v1/tiktok/users/{username} operations: - name: tiktokgetuser method: GET description: Get User Profile outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: username in: path type: string description: TikTok username (with or without @ symbol) required: true - name: v1-tiktok-users-username-collections path: /v1/tiktok/users/{username}/collections operations: - name: tiktokgetusercollections method: GET description: Get User Collections outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: username in: path type: string description: TikTok username (with or without @ symbol) required: true - name: count in: query type: integer description: 'Number of collections to fetch (maximum: 30)' - name: cursor in: query type: string description: Pagination cursor - name: v1-tiktok-users-username-followers path: /v1/tiktok/users/{username}/followers operations: - name: tiktokgetuserfollowers method: GET description: Get User Followers List outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: username in: path type: string description: TikTok username (with or without @ symbol) required: true - name: count in: query type: integer description: 'Number of users to fetch (maximum: 30)' - name: cursor in: query type: string description: Pagination cursor - name: v1-tiktok-users-username-following path: /v1/tiktok/users/{username}/following operations: - name: tiktokgetuserfollowing method: GET description: Get User Following List outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: username in: path type: string description: TikTok username (with or without @ symbol) required: true - name: count in: query type: integer description: 'Number of users to fetch (maximum: 30)' - name: cursor in: query type: string description: Pagination cursor - name: v1-tiktok-users-username-likes path: /v1/tiktok/users/{username}/likes operations: - name: tiktokgetuserlikes method: GET description: Get User Liked Videos outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: username in: path type: string description: TikTok username (with or without @ symbol) required: true - name: count in: query type: integer description: 'Number of videos to fetch (maximum: 35)' - name: cursor in: query type: string description: Pagination cursor - name: v1-tiktok-users-username-live path: /v1/tiktok/users/{username}/live operations: - name: tiktokgetuserlive method: GET description: Get User Live Stream outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: username in: path type: string description: TikTok username (with or without @ symbol) required: true - name: v1-tiktok-users-username-reposts path: /v1/tiktok/users/{username}/reposts operations: - name: tiktokgetuserreposts method: GET description: Get User Reposts outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: username in: path type: string description: TikTok username (with or without @ symbol) required: true - name: count in: query type: integer description: 'Number of videos to fetch (maximum: 30)' - name: cursor in: query type: string description: Pagination cursor - name: order in: query type: string description: 'Sort order: newest (default), popular, or oldest' - name: v1-tiktok-users-username-stories path: /v1/tiktok/users/{username}/stories operations: - name: tiktokgetuserstories method: GET description: Get User Stories outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: username in: path type: string description: TikTok username (with or without @ symbol) required: true - name: count in: query type: integer description: 'Number of stories to fetch (maximum: 35)' - name: cursor in: query type: string description: Pagination cursor - name: v1-tiktok-users-username-videos path: /v1/tiktok/users/{username}/videos operations: - name: tiktokgetuservideos method: GET description: Get User Videos outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: username in: path type: string description: TikTok username (with or without @ symbol) required: true - name: count in: query type: integer description: 'Number of videos to fetch (maximum: 35)' - name: cursor in: query type: string description: Pagination cursor - name: order in: query type: string description: 'Sort order: newest (default), popular, or oldest' - name: v1-tiktok-videos-videoId path: /v1/tiktok/videos/{videoId} operations: - name: tiktokgetvideo method: GET description: Get Video Details outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: videoId in: path type: string description: TikTok video ID required: true - name: v1-tiktok-videos-videoId-comments path: /v1/tiktok/videos/{videoId}/comments operations: - name: tiktokgetvideocomments method: GET description: Get Video Comments outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: videoId in: path type: string description: TikTok video ID required: true - name: count in: query type: integer description: 'Number of comments to fetch (maximum: 50)' - name: cursor in: query type: string description: Pagination cursor - name: v1-tiktok-videos-videoId-comments-commentId-replies path: /v1/tiktok/videos/{videoId}/comments/{commentId}/replies operations: - name: tiktokgetcommentreplies method: GET description: Get Comment Replies outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: videoId in: path type: string description: TikTok video ID required: true - name: commentId in: path type: string description: TikTok comment ID required: true - name: count in: query type: integer description: 'Number of replies to fetch (maximum: 50)' - name: cursor in: query type: string description: Pagination cursor - name: v1-tiktok-videos-videoId-transcripts-language path: /v1/tiktok/videos/{videoId}/transcripts/{language} operations: - name: tiktokgetvideotranscript method: GET description: Get Video Transcript outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: videoId in: path type: string description: TikTok video ID required: true - name: language in: path type: string description: BCP47 language code required: true authentication: type: bearer token: '{{env.KONBINIAPI_API_KEY}}' exposes: - type: rest namespace: konbiniapi-tiktok-rest port: 8080 description: REST adapter for KonbiniAPI — TikTok. One Spectral-compliant resource per consumed operation, prefixed with /v1. resources: - path: /v1/v1/tiktok/audios/{audioid} name: v1-tiktok-audios-audioid description: REST surface for v1-tiktok-audios-audioId. operations: - method: GET name: tiktokgetaudio description: Get Audio Details call: konbiniapi-tiktok.tiktokgetaudio with: audioId: rest.audioId outputParameters: - type: object mapping: $. - path: /v1/v1/tiktok/audios/{audioid}/videos name: v1-tiktok-audios-audioid-videos description: REST surface for v1-tiktok-audios-audioId-videos. operations: - method: GET name: tiktokgetaudiovideos description: Get Videos with Audio call: konbiniapi-tiktok.tiktokgetaudiovideos with: audioId: rest.audioId count: rest.count cursor: rest.cursor outputParameters: - type: object mapping: $. - path: /v1/v1/tiktok/collections/{collectionid} name: v1-tiktok-collections-collectionid description: REST surface for v1-tiktok-collections-collectionId. operations: - method: GET name: tiktokgetcollectionvideos description: Get Collection Videos call: konbiniapi-tiktok.tiktokgetcollectionvideos with: collectionId: rest.collectionId count: rest.count cursor: rest.cursor outputParameters: - type: object mapping: $. - path: /v1/v1/tiktok/search name: v1-tiktok-search description: REST surface for v1-tiktok-search. operations: - method: GET name: tiktoksearchcontent description: Search Content call: konbiniapi-tiktok.tiktoksearchcontent with: query: rest.query cursor: rest.cursor count: rest.count order: rest.order published: rest.published outputParameters: - type: object mapping: $. - path: /v1/v1/tiktok/search/users name: v1-tiktok-search-users description: REST surface for v1-tiktok-search-users. operations: - method: GET name: tiktoksearchusers description: Search Users call: konbiniapi-tiktok.tiktoksearchusers with: query: rest.query count: rest.count cursor: rest.cursor outputParameters: - type: object mapping: $. - path: /v1/v1/tiktok/search/videos name: v1-tiktok-search-videos description: REST surface for v1-tiktok-search-videos. operations: - method: GET name: tiktoksearchvideos description: Search Videos call: konbiniapi-tiktok.tiktoksearchvideos with: query: rest.query cursor: rest.cursor count: rest.count order: rest.order published: rest.published outputParameters: - type: object mapping: $. - path: /v1/v1/tiktok/tags/{tagname} name: v1-tiktok-tags-tagname description: REST surface for v1-tiktok-tags-tagName. operations: - method: GET name: tiktokgettagvideos description: Get Videos with Tag call: konbiniapi-tiktok.tiktokgettagvideos with: tagName: rest.tagName count: rest.count cursor: rest.cursor outputParameters: - type: object mapping: $. - path: /v1/v1/tiktok/users/{username} name: v1-tiktok-users-username description: REST surface for v1-tiktok-users-username. operations: - method: GET name: tiktokgetuser description: Get User Profile call: konbiniapi-tiktok.tiktokgetuser with: username: rest.username outputParameters: - type: object mapping: $. - path: /v1/v1/tiktok/users/{username}/collections name: v1-tiktok-users-username-collections description: REST surface for v1-tiktok-users-username-collections. operations: - method: GET name: tiktokgetusercollections description: Get User Collections call: konbiniapi-tiktok.tiktokgetusercollections with: username: rest.username count: rest.count cursor: rest.cursor outputParameters: - type: object mapping: $. - path: /v1/v1/tiktok/users/{username}/followers name: v1-tiktok-users-username-followers description: REST surface for v1-tiktok-users-username-followers. operations: - method: GET name: tiktokgetuserfollowers description: Get User Followers List call: konbiniapi-tiktok.tiktokgetuserfollowers with: username: rest.username count: rest.count cursor: rest.cursor outputParameters: - type: object mapping: $. - path: /v1/v1/tiktok/users/{username}/following name: v1-tiktok-users-username-following description: REST surface for v1-tiktok-users-username-following. operations: - method: GET name: tiktokgetuserfollowing description: Get User Following List call: konbiniapi-tiktok.tiktokgetuserfollowing with: username: rest.username count: rest.count cursor: rest.cursor outputParameters: - type: object mapping: $. - path: /v1/v1/tiktok/users/{username}/likes name: v1-tiktok-users-username-likes description: REST surface for v1-tiktok-users-username-likes. operations: - method: GET name: tiktokgetuserlikes description: Get User Liked Videos call: konbiniapi-tiktok.tiktokgetuserlikes with: username: rest.username count: rest.count cursor: rest.cursor outputParameters: - type: object mapping: $. - path: /v1/v1/tiktok/users/{username}/live name: v1-tiktok-users-username-live description: REST surface for v1-tiktok-users-username-live. operations: - method: GET name: tiktokgetuserlive description: Get User Live Stream call: konbiniapi-tiktok.tiktokgetuserlive with: username: rest.username outputParameters: - type: object mapping: $. - path: /v1/v1/tiktok/users/{username}/reposts name: v1-tiktok-users-username-reposts description: REST surface for v1-tiktok-users-username-reposts. operations: - method: GET name: tiktokgetuserreposts description: Get User Reposts call: konbiniapi-tiktok.tiktokgetuserreposts with: username: rest.username count: rest.count cursor: rest.cursor order: rest.order outputParameters: - type: object mapping: $. - path: /v1/v1/tiktok/users/{username}/stories name: v1-tiktok-users-username-stories description: REST surface for v1-tiktok-users-username-stories. operations: - method: GET name: tiktokgetuserstories description: Get User Stories call: konbiniapi-tiktok.tiktokgetuserstories with: username: rest.username count: rest.count cursor: rest.cursor outputParameters: - type: object mapping: $. - path: /v1/v1/tiktok/users/{username}/videos name: v1-tiktok-users-username-videos description: REST surface for v1-tiktok-users-username-videos. operations: - method: GET name: tiktokgetuservideos description: Get User Videos call: konbiniapi-tiktok.tiktokgetuservideos with: username: rest.username count: rest.count cursor: rest.cursor order: rest.order outputParameters: - type: object mapping: $. - path: /v1/v1/tiktok/videos/{videoid} name: v1-tiktok-videos-videoid description: REST surface for v1-tiktok-videos-videoId. operations: - method: GET name: tiktokgetvideo description: Get Video Details call: konbiniapi-tiktok.tiktokgetvideo with: videoId: rest.videoId outputParameters: - type: object mapping: $. - path: /v1/v1/tiktok/videos/{videoid}/comments name: v1-tiktok-videos-videoid-comments description: REST surface for v1-tiktok-videos-videoId-comments. operations: - method: GET name: tiktokgetvideocomments description: Get Video Comments call: konbiniapi-tiktok.tiktokgetvideocomments with: videoId: rest.videoId count: rest.count cursor: rest.cursor outputParameters: - type: object mapping: $. - path: /v1/v1/tiktok/videos/{videoid}/comments/{commentid}/replies name: v1-tiktok-videos-videoid-comments-commentid-replies description: REST surface for v1-tiktok-videos-videoId-comments-commentId-replies. operations: - method: GET name: tiktokgetcommentreplies description: Get Comment Replies call: konbiniapi-tiktok.tiktokgetcommentreplies with: videoId: rest.videoId commentId: rest.commentId count: rest.count cursor: rest.cursor outputParameters: - type: object mapping: $. - path: /v1/v1/tiktok/videos/{videoid}/transcripts/{language} name: v1-tiktok-videos-videoid-transcripts-language description: REST surface for v1-tiktok-videos-videoId-transcripts-language. operations: - method: GET name: tiktokgetvideotranscript description: Get Video Transcript call: konbiniapi-tiktok.tiktokgetvideotranscript with: videoId: rest.videoId language: rest.language outputParameters: - type: object mapping: $. - type: mcp namespace: konbiniapi-tiktok-mcp port: 9090 transport: http description: MCP adapter for KonbiniAPI — TikTok. One tool per consumed operation, routed inline through this capability's consumes block. tools: - name: get-audio-details description: Get Audio Details hints: readOnly: true destructive: false idempotent: true call: konbiniapi-tiktok.tiktokgetaudio with: audioId: tools.audioId outputParameters: - type: object mapping: $. - name: get-videos-audio description: Get Videos with Audio hints: readOnly: true destructive: false idempotent: true call: konbiniapi-tiktok.tiktokgetaudiovideos with: audioId: tools.audioId count: tools.count cursor: tools.cursor outputParameters: - type: object mapping: $. - name: get-collection-videos description: Get Collection Videos hints: readOnly: true destructive: false idempotent: true call: konbiniapi-tiktok.tiktokgetcollectionvideos with: collectionId: tools.collectionId count: tools.count cursor: tools.cursor outputParameters: - type: object mapping: $. - name: search-content description: Search Content hints: readOnly: true destructive: false idempotent: true call: konbiniapi-tiktok.tiktoksearchcontent with: query: tools.query cursor: tools.cursor count: tools.count order: tools.order published: tools.published outputParameters: - type: object mapping: $. - name: search-users description: Search Users hints: readOnly: true destructive: false idempotent: true call: konbiniapi-tiktok.tiktoksearchusers with: query: tools.query count: tools.count cursor: tools.cursor outputParameters: - type: object mapping: $. - name: search-videos description: Search Videos hints: readOnly: true destructive: false idempotent: true call: konbiniapi-tiktok.tiktoksearchvideos with: query: tools.query cursor: tools.cursor count: tools.count order: tools.order published: tools.published outputParameters: - type: object mapping: $. - name: get-videos-tag description: Get Videos with Tag hints: readOnly: true destructive: false idempotent: true call: konbiniapi-tiktok.tiktokgettagvideos with: tagName: tools.tagName count: tools.count cursor: tools.cursor outputParameters: - type: object mapping: $. - name: get-user-profile description: Get User Profile hints: readOnly: true destructive: false idempotent: true call: konbiniapi-tiktok.tiktokgetuser with: username: tools.username outputParameters: - type: object mapping: $. - name: get-user-collections description: Get User Collections hints: readOnly: true destructive: false idempotent: true call: konbiniapi-tiktok.tiktokgetusercollections with: username: tools.username count: tools.count cursor: tools.cursor outputParameters: - type: object mapping: $. - name: get-user-followers-list description: Get User Followers List hints: readOnly: true destructive: false idempotent: true call: konbiniapi-tiktok.tiktokgetuserfollowers with: username: tools.username count: tools.count cursor: tools.cursor outputParameters: - type: object mapping: $. - name: get-user-following-list description: Get User Following List hints: readOnly: true destructive: false idempotent: true call: konbiniapi-tiktok.tiktokgetuserfollowing with: username: tools.username count: tools.count cursor: tools.cursor outputParameters: - type: object mapping: $. - name: get-user-liked-videos description: Get User Liked Videos hints: readOnly: true destructive: false idempotent: true call: konbiniapi-tiktok.tiktokgetuserlikes with: username: tools.username count: tools.count cursor: tools.cursor outputParameters: - type: object mapping: $. - name: get-user-live-stream description: Get User Live Stream hints: readOnly: true destructive: false idempotent: true call: konbiniapi-tiktok.tiktokgetuserlive with: username: tools.username outputParameters: - type: object mapping: $. - name: get-user-reposts description: Get User Reposts hints: readOnly: true destructive: false idempotent: true call: konbiniapi-tiktok.tiktokgetuserreposts with: username: tools.username count: tools.count cursor: tools.cursor order: tools.order outputParameters: - type: object mapping: $. - name: get-user-stories description: Get User Stories hints: readOnly: true destructive: false idempotent: true call: konbiniapi-tiktok.tiktokgetuserstories with: username: tools.username count: tools.count cursor: tools.cursor outputParameters: - type: object mapping: $. - name: get-user-videos description: Get User Videos hints: readOnly: true destructive: false idempotent: true call: konbiniapi-tiktok.tiktokgetuservideos with: username: tools.username count: tools.count cursor: tools.cursor order: tools.order outputParameters: - type: object mapping: $. - name: get-video-details description: Get Video Details hints: readOnly: true destructive: false idempotent: true call: konbiniapi-tiktok.tiktokgetvideo with: videoId: tools.videoId outputParameters: - type: object mapping: $. - name: get-video-comments description: Get Video Comments hints: readOnly: true destructive: false idempotent: true call: konbiniapi-tiktok.tiktokgetvideocomments with: videoId: tools.videoId count: tools.count cursor: tools.cursor outputParameters: - type: object mapping: $. - name: get-comment-replies description: Get Comment Replies hints: readOnly: true destructive: false idempotent: true call: konbiniapi-tiktok.tiktokgetcommentreplies with: videoId: tools.videoId commentId: tools.commentId count: tools.count cursor: tools.cursor outputParameters: - type: object mapping: $. - name: get-video-transcript description: Get Video Transcript hints: readOnly: true destructive: false idempotent: true call: konbiniapi-tiktok.tiktokgetvideotranscript with: videoId: tools.videoId language: tools.language outputParameters: - type: object mapping: $.