{"openapi":"3.1.0","info":{"title":"KonbiniAPI","version":"1.0.0","description":"Social media API that normalizes Instagram, TikTok, X, Reddit, and LinkedIn data into a consistent ActivityStreams 2.0 format.\n\nEvery authenticated response includes `X-Credits-Remaining` and `X-Credits-Used` headers. Each successful request costs 1 credit. Requests that fail with 400, 5xx, or upstream errors are refunded (X-Credits-Used: 0).","contact":{"name":"KonbiniAPI","email":"hello@konbiniapi.com","url":"https://konbiniapi.com"}},"servers":[{"url":"https://api.konbiniapi.com","description":"Production"}],"tags":[{"name":"Instagram","description":"Instagram data endpoints"},{"name":"TikTok","description":"TikTok data endpoints"},{"name":"X","description":"X data endpoints"},{"name":"Reddit","description":"Reddit data endpoints"},{"name":"LinkedIn","description":"LinkedIn data endpoints"}],"security":[{"apiKey":[]}],"components":{"securitySchemes":{"apiKey":{"type":"http","scheme":"bearer","description":"Send your API key in the Authorization header as a Bearer token.\nExample: `Authorization: Bearer <your-api-key>`"}},"schemas":{"TikTokLink":{"type":"object","properties":{"type":{"type":"string","description":"ActivityStreams object type","example":"Link"},"href":{"type":"string","format":"uri","description":"Link URL","example":"https://linktr.ee/khaby.lame"},"rel":{"type":"string","description":"Link relation hint","example":"preferred"}},"required":["type","href"],"description":"External link"},"TikTokImage":{"type":"object","properties":{"type":{"type":"string","description":"ActivityStreams object type","example":"Image"},"url":{"type":"string","format":"uri","description":"Image URL","example":"https://p16-sign.tiktokcdn-us.com/tos-maliva-avt-0068/avatar.jpeg"},"width":{"type":"integer","description":"Width in pixels","example":576},"height":{"type":"integer","description":"Height in pixels","example":1024}},"required":["type","url"],"description":"Image resource with optional dimensions"},"TikTokVideo":{"type":"object","properties":{"type":{"type":"string","description":"ActivityStreams object type","example":"Video"},"id":{"type":"string","format":"uri","description":"Video permalink","example":"https://www.tiktok.com/@khaby.lame/video/7611615657754381599"},"url":{"type":"string","format":"uri","description":"Video URL","example":"https://www.tiktok.com/@khaby.lame/video/7611615657754381599"},"entityId":{"type":"string","description":"TikTok internal video ID","example":"7611615657754381599"},"content":{"type":"string","description":"Caption or description","example":"When you realize there is a simpler way #learnfromkhaby"},"published":{"type":"string","format":"date-time","description":"Publication date in ISO 8601 format","example":"2026-02-27T18:36:42.000Z"},"duration":{"type":"number","description":"Duration in seconds","example":23},"viewCount":{"type":"integer","description":"Number of views","example":42600000},"likeCount":{"type":"integer","description":"Number of likes","example":2800000},"commentCount":{"type":"integer","description":"Number of comments","example":29200},"repostCount":{"type":"integer","description":"Number of reposts","example":0},"shareCount":{"type":"integer","description":"Number of shares","example":157700},"saveCount":{"type":"integer","description":"Number of saves","example":153238},"language":{"type":"string","description":"Content language (BCP47 code)","example":"en"},"isSponsored":{"type":"boolean","description":"Whether the video is a promoted ad","example":false},"location":{"type":"object","properties":{"type":{"type":"string","description":"ActivityStreams object type","example":"Place"},"id":{"type":"string","description":"Location ID","example":"213385402"},"name":{"type":"string","description":"Location name or country code","example":"Los Angeles, California"},"url":{"type":"string","format":"uri","description":"Location page URL"},"latitude":{"type":"number","description":"Geographic latitude","example":34.0522},"longitude":{"type":"number","description":"Geographic longitude","example":-118.2437}},"required":["type","name"],"description":"Location where the video was created","example":{"type":"Place","name":"US"}},"tag":{"type":"array","items":{"$ref":"#/components/schemas/TikTokTag"},"description":"Hashtags and mentions"},"attributedTo":{"$ref":"#/components/schemas/TikTokEmbeddedUser","description":"Video creator"},"attachment":{"type":"array","items":{"$ref":"#/components/schemas/TikTokVideoAttachment"},"description":"Video files in multiple qualities"},"image":{"type":"array","items":{"$ref":"#/components/schemas/TikTokImage"},"description":"Video thumbnails"},"preview":{"allOf":[{"$ref":"#/components/schemas/TikTokImage"},{"description":"Animated preview thumbnail"}]},"audio":{"$ref":"#/components/schemas/TikTokAudio","description":"Video audio track"}},"required":["type","id","url","entityId","published","viewCount","likeCount","commentCount","repostCount","shareCount","saveCount","attributedTo"],"description":"Video post"},"TikTokTag":{"type":"object","properties":{"type":{"type":"string","description":"ActivityStreams object type","example":"Tag"},"name":{"type":"string","description":"Tag name","example":"learnfromkhaby"},"href":{"type":"string","format":"uri","description":"Tag URL","example":"https://www.tiktok.com/tag/learnfromkhaby"},"id":{"type":"string","format":"uri","description":"Tag permalink","example":"https://www.tiktok.com/tag/learnfromkhaby"},"entityId":{"type":"string","description":"TikTok internal tag ID","example":"1697657584273413"}},"required":["type","name"],"description":"Hashtag or mention"},"TikTokEmbeddedUser":{"type":"object","properties":{"type":{"type":"string","description":"ActivityStreams object type","example":"Person"},"id":{"type":"string","format":"uri","description":"Profile URL","example":"https://www.tiktok.com/@khaby.lame"},"url":{"type":"string","format":"uri","description":"Profile URL","example":"https://www.tiktok.com/@khaby.lame"},"entityId":{"type":"string","description":"TikTok secUid","example":"MS4wLjABAAAAwAg0rSzO65WQfz4RzQgGv2Xdv108BgPXhRrrmNVIHQZ9PO8-flwwRtEppYTS0OjA"},"name":{"type":"string","description":"Display name","example":"Khabane Lame"},"preferredUsername":{"type":"string","description":"Username or handle","example":"khaby.lame"},"summary":{"type":"string","description":"Bio text","example":"Just a guy who reacts"},"attachment":{"type":"array","items":{"$ref":"#/components/schemas/TikTokLink"},"description":"External links in bio"},"published":{"type":"string","format":"date-time","description":"Account creation date in ISO 8601 format","example":"2020-03-15T00:00:00.000Z"},"isPrivate":{"type":"boolean","description":"Whether account is private","example":false},"isVerified":{"type":"boolean","description":"Whether account is verified","example":true},"isLive":{"type":"boolean","description":"Whether user is currently live streaming","example":false},"hasLikes":{"type":"boolean","description":"Whether user's liked videos are public","example":true},"hasPlaylists":{"type":"boolean","description":"Whether user has playlists","example":true},"followerCount":{"type":"integer","description":"Number of followers","example":160300000},"followingCount":{"type":"integer","description":"Number of accounts followed","example":85},"language":{"type":"string","description":"User language preference (BCP47 code)","example":"en"},"likeCount":{"type":"integer","description":"Total likes received across all content","example":2600000000},"likedCount":{"type":"integer","description":"Number of videos the user has liked","example":5300},"mediaCount":{"type":"integer","description":"Number of posts","example":1309},"icon":{"allOf":[{"$ref":"#/components/schemas/TikTokImage"},{"description":"Author avatar"}]},"image":{"type":"array","items":{"$ref":"#/components/schemas/TikTokImage"},"description":"Profile pictures in multiple sizes"}},"required":["type","id","url","isPrivate","isVerified"],"description":"Compact user profile for embedded contexts"},"TikTokVideoAttachment":{"type":"object","properties":{"type":{"type":"string","description":"ActivityStreams object type","example":"Video"},"name":{"type":"string","description":"Quality label (e.g. h264_540p_829898-0)","example":"normal_540_0"},"url":{"type":"array","items":{"type":"string","format":"uri"},"description":"Media download URLs","example":["https://v19-webapp.tiktok.com/video/tos/us/tos-useast5-ve-0068c004/video.mp4"]},"headers":{"$ref":"#/components/schemas/TikTokVideoAttachmentHeaders","description":"Authentication headers for video download"},"mediaType":{"type":"string","description":"MIME type","example":"video/mp4"},"codec":{"type":"string","description":"Video codec (e.g. h264, h265)","example":"h264"},"width":{"type":"integer","description":"Width in pixels","example":576},"height":{"type":"integer","description":"Height in pixels","example":1024},"bitrate":{"type":"integer","description":"Bitrate in bits per second","example":1101943}},"required":["type","name","url","mediaType","codec","width","height","bitrate"],"description":"Video media file with download details"},"TikTokVideoAttachmentHeaders":{"type":"object","properties":{"Cookie":{"type":"string","description":"Required cookie header for video download","example":"tt_chain_token=sTA6PK6OnvhW7YemGVwMig=="},"Referer":{"type":"string","description":"Required referer header for video download","example":"https://www.tiktok.com/"}},"required":["Cookie","Referer"],"description":"HTTP headers required for authenticated media download"},"TikTokAudio":{"type":"object","properties":{"type":{"type":"string","description":"ActivityStreams object type","example":"Audio"},"id":{"type":"string","format":"uri","description":"Audio permalink","example":"https://www.tiktok.com/music/original-sound-7611615657754381599"},"url":{"type":"string","format":"uri","description":"Audio playback URL","example":"https://sf16-ies-music.tiktokcdn.com/obj/tos-alisg-v/123456"},"name":{"type":"string","description":"Track name","example":"original sound"},"duration":{"type":"number","description":"Duration in seconds","example":23},"mediaType":{"type":"string","description":"MIME type","example":"audio/mpeg"},"attributedTo":{"anyOf":[{"$ref":"#/components/schemas/TikTokEmbeddedUser"},{"type":"array","items":{"$ref":"#/components/schemas/TikTokEmbeddedUser"}}],"description":"Audio creator or artist"},"icon":{"allOf":[{"$ref":"#/components/schemas/TikTokImage"},{"description":"Thumbnail image"}]},"image":{"type":"array","items":{"$ref":"#/components/schemas/TikTokImage"},"description":"Cover images in multiple sizes"},"entityId":{"type":"string","description":"Audio ID","example":"7493556331997071377"},"album":{"type":"string","description":"Album name","example":"Greatest Hits"},"isOriginal":{"type":"boolean","description":"Whether audio is user-created vs a licensed track","example":false},"isCopyrighted":{"type":"boolean","description":"Whether audio has copyright restrictions","example":false},"videoCount":{"type":"integer","description":"Number of videos using this audio","example":500000}},"required":["type","name","duration"],"description":"Audio or music track"},"TikTokCollection":{"type":"object","properties":{"type":{"type":"string","description":"ActivityStreams object type","example":"OrderedCollection"},"id":{"type":"string","format":"uri","description":"Collection permalink","example":"https://www.tiktok.com/@khaby.lame/playlist/7200000000000000001"},"name":{"type":"string","description":"Collection name","example":"Best of 2025"},"image":{"type":"array","items":{"$ref":"#/components/schemas/TikTokImage"},"description":"Collection cover images"},"totalItems":{"type":["integer","null"],"description":"Number of items in collection","example":42},"entityId":{"type":"string","description":"TikTok internal collection ID","example":"7200000000000000001"},"attributedTo":{"allOf":[{"$ref":"#/components/schemas/TikTokEmbeddedUser"},{"description":"Collection owner"}]}},"required":["type","id","name","totalItems","entityId","attributedTo"],"description":"Video collection or playlist"},"TikTokStory":{"type":"object","properties":{"type":{"type":"string","description":"ActivityStreams object type","example":"Video"},"id":{"type":"string","format":"uri","description":"Story permalink","example":"https://www.tiktok.com/@khaby.lame/video/7600000000000000000"},"url":{"type":"string","format":"uri","description":"Story URL","example":"https://www.tiktok.com/@khaby.lame/video/7600000000000000000"},"entityId":{"type":"string","description":"TikTok internal story ID","example":"7600000000000000000"},"content":{"type":"string","description":"Caption or description","example":"When you realize there is a simpler way #learnfromkhaby"},"published":{"type":"string","format":"date-time","description":"Publication date in ISO 8601 format","example":"2026-02-27T18:36:42.000Z"},"endTime":{"type":"string","format":"date-time","description":"Story expiration date in ISO 8601 format","example":"2026-02-28T18:36:42.000Z"},"viewCount":{"type":"integer","description":"Number of views","example":42600000},"likeCount":{"type":"integer","description":"Number of likes","example":2800000},"commentCount":{"type":"integer","description":"Number of comments","example":29200},"repostCount":{"type":"integer","description":"Number of reposts","example":0},"shareCount":{"type":"integer","description":"Number of shares","example":157700},"saveCount":{"type":"integer","description":"Number of saves","example":153238},"attributedTo":{"allOf":[{"$ref":"#/components/schemas/TikTokEmbeddedUser"},{"description":"Story author"}]},"duration":{"type":"number","description":"Duration in seconds","example":23},"attachment":{"type":"array","items":{"$ref":"#/components/schemas/TikTokStoryAttachment"},"description":"Video files"},"image":{"type":"array","items":{"$ref":"#/components/schemas/TikTokImage"},"description":"Story images"},"preview":{"allOf":[{"$ref":"#/components/schemas/TikTokImage"},{"description":"Animated preview thumbnail"}]},"audio":{"allOf":[{"$ref":"#/components/schemas/TikTokAudio"},{"description":"Story audio track"}]}},"required":["type","id","url","entityId","published","viewCount","likeCount","commentCount","repostCount","shareCount","saveCount","attributedTo"],"description":"Story post"},"TikTokStoryAttachment":{"type":"object","properties":{"type":{"type":"string","description":"ActivityStreams object type","example":"Video"},"url":{"type":"array","items":{"type":"string","format":"uri"},"description":"Media download URLs","example":["https://v19-webapp.tiktok.com/video/tos/us/tos-useast5-ve-0068c004/story.mp4"]},"mediaType":{"type":"string","description":"MIME type","example":"video/mp4"},"width":{"type":"integer","description":"Width in pixels","example":576},"height":{"type":"integer","description":"Height in pixels","example":1024},"name":{"type":"string","description":"Quality label","example":"normal_540_0"},"headers":{"allOf":[{"$ref":"#/components/schemas/TikTokVideoAttachmentHeaders"},{"description":"Authentication headers for story download"}]},"codec":{"type":"string","description":"Video codec","example":"h264"},"bitrate":{"type":"integer","description":"Bitrate in bits per second","example":1101943}},"required":["type","url"],"description":"Story media file"},"TikTokLiveStreamAttachment":{"type":"object","properties":{"type":{"type":"string","description":"ActivityStreams object type","example":"Video"},"url":{"type":"array","items":{"type":"string","format":"uri"},"description":"Media download URLs","example":["https://webcast.tiktok.com/live/pull/l4/stream.flv"]},"mediaType":{"type":"string","description":"MIME type","example":"video/x-flv"},"width":{"type":"integer","description":"Width in pixels","example":576},"height":{"type":"integer","description":"Height in pixels","example":1024},"name":{"type":"string","description":"Stream quality label","example":"flv"},"codec":{"type":"string","description":"Video codec","example":"h264"},"bitrate":{"type":"integer","description":"Bitrate in bits per second","example":2500000}},"required":["type","url","mediaType","name"],"description":"Live stream media source"},"TikTokVideoDownloadUrl":{"type":"object","properties":{"@context":{"type":"array","prefixItems":[{"type":"string","enum":["https://www.w3.org/ns/activitystreams#"]},{"type":"string","enum":["https://konbiniapi.com/ns/social#"]}],"description":"ActivityStreams JSON-LD context","example":["https://www.w3.org/ns/activitystreams#","https://konbiniapi.com/ns/social#"]},"type":{"type":"string","enum":["Video"],"example":"Video"},"url":{"type":"string","format":"uri","description":"Downloadable video file URL. Works with a plain GET request — no cookies, auth headers, or special HTTP client required. Not permanent, only valid for a few hours — do not store it for later use, request a fresh one when you need it.","example":"https://v16m-default.tiktokcdn-us.com/tos-useast2a-ve-0068c001-euttp/oQmXqQqQ1RQkQKEZe6EDMBnZDGFHLupqRIh7p/?a=1988&bti=bGRuZHxvMXIxcm53Zm1cYF9ebWFzaHFmOg%3D%3D&bt=1415&ft=8kQr2FziNORWRapNGIv1tec7kzYrZmXVWxi~jJMsL&mime_type=video_mp4&vvpl=1"},"mediaType":{"type":"string","enum":["video/mp4"],"example":"video/mp4"}},"required":["@context","type","url","mediaType"],"description":"A temporary link to a downloadable video file"},"TikTokComment":{"type":"object","properties":{"type":{"type":"string","description":"ActivityStreams object type","example":"Note"},"id":{"type":"string","format":"uri","description":"Comment permalink","example":"https://www.tiktok.com/@khaby.lame/video/7611615657754381599/comment/7611646895321105170"},"url":{"type":"string","format":"uri","description":"Comment permalink","example":"https://www.tiktok.com/@khaby.lame/video/7611615657754381599/comment/7611646895321105170"},"entityId":{"type":"string","description":"TikTok internal comment ID","example":"7611646895321105170"},"content":{"type":"string","description":"Comment text","example":"This man hasn't been in my fyp for so long"},"language":{"type":"string","description":"Comment language code","example":"en"},"published":{"type":"string","format":"date-time","description":"Publication date in ISO 8601 format","example":"2026-02-27T20:37:38.000Z"},"likeCount":{"type":"integer","description":"Number of likes","example":93210},"replyCount":{"type":"integer","description":"Number of replies","example":96},"status":{"type":"string","description":"Moderation status","example":"1"},"isPinned":{"type":"boolean","description":"Whether comment is pinned","example":false},"isLiked":{"type":"boolean","description":"Whether comment is liked by the video author","example":false},"attributedTo":{"allOf":[{"$ref":"#/components/schemas/TikTokEmbeddedUser"},{"description":"Comment author"}]},"inReplyTo":{"type":"string","format":"uri","description":"URL of parent content","example":"https://www.tiktok.com/@khaby.lame/video/7611615657754381599"}},"required":["type","id","content","likeCount","attributedTo"],"description":"Video comment"},"InstagramLink":{"type":"object","properties":{"type":{"type":"string","description":"ActivityStreams object type","example":"Link"},"href":{"type":"string","format":"uri","description":"Link URL","example":"https://linktr.ee/khabylame"},"rel":{"type":"string","description":"Link relation hint","example":"preferred"}},"required":["type","href"],"description":"External link"},"InstagramImage":{"type":"object","properties":{"type":{"type":"string","description":"ActivityStreams object type","example":"Image"},"url":{"type":"string","format":"uri","description":"Image URL","example":"https://scontent.cdninstagram.com/v/t51.2885-19/avatar.jpg"}},"required":["type","url"],"description":"Image resource"},"InstagramPost":{"type":"object","properties":{"type":{"type":"string","description":"ActivityStreams object type","example":"Video"},"id":{"type":"string","format":"uri","description":"Post permalink","example":"https://www.instagram.com/p/CybWViruta1/"},"url":{"type":"string","format":"uri","description":"Post URL","example":"https://www.instagram.com/p/CybWViruta1/"},"entityId":{"type":"string","description":"Post shortcode (used as lookup key)","example":"CybWViruta1"},"content":{"type":"string","description":"Caption or description","example":"When you realize there is a simpler way #learnfromkhaby"},"published":{"type":"string","format":"date-time","description":"Publication date in ISO 8601 format","example":"2026-02-27T18:36:42.000Z"},"likeCount":{"type":"integer","description":"Number of likes","example":2800000},"commentCount":{"type":"integer","description":"Number of comments","example":29200},"attributedTo":{"anyOf":[{"$ref":"#/components/schemas/InstagramEmbeddedUser"},{"type":"array","items":{"$ref":"#/components/schemas/InstagramEmbeddedUser"}}],"description":"Post author or collaborators"},"location":{"$ref":"#/components/schemas/InstagramLocation","description":"Post location tag"},"tag":{"type":"array","items":{"$ref":"#/components/schemas/InstagramTag"},"description":"Tagged users or hashtags"},"language":{"type":"string","description":"Content language (BCP47 code)","example":"en"},"isEdited":{"type":"boolean","description":"Whether the caption has been edited","example":false},"isSponsored":{"type":"boolean","description":"Whether post is a paid partnership","example":false},"viewCount":{"type":"integer","description":"Number of views","example":42600000},"duration":{"type":"number","description":"Duration in seconds","example":23},"contentFormat":{"type":"string","description":"Content format (e.g. video, reel, igtv)","example":"reel"},"attachment":{"type":"array","items":{"$ref":"#/components/schemas/InstagramAttachment"},"description":"Media files"},"image":{"type":"array","items":{"$ref":"#/components/schemas/InstagramImageWithDimensions"},"description":"Post images"},"audio":{"$ref":"#/components/schemas/InstagramAudio","description":"Post audio track"},"name":{"type":"string","description":"Alt text or accessibility caption","example":"Photo of Khabane Lame"},"totalItems":{"type":"integer","description":"Number of carousel items","example":5},"items":{"type":"array","items":{"$ref":"#/components/schemas/InstagramCarouselItem"},"description":"Carousel slides"}},"required":["type","id","url","entityId"],"description":"Instagram post (photo, video, or carousel)"},"InstagramEmbeddedUser":{"type":"object","properties":{"type":{"type":"string","description":"ActivityStreams object type","example":"Person"},"id":{"type":"string","format":"uri","description":"Profile URL","example":"https://www.instagram.com/khaby00/"},"url":{"type":"string","format":"uri","description":"Profile URL","example":"https://www.instagram.com/khaby00/"},"entityId":{"type":"string","description":"Platform-specific entity ID","example":"779085683"},"preferredUsername":{"type":"string","description":"Username or handle","example":"khaby00"},"name":{"type":"string","description":"Display name","example":"Khabane Lame"},"icon":{"allOf":[{"$ref":"#/components/schemas/InstagramImage"},{"description":"Author avatar"}]},"role":{"type":"string","description":"Role label (e.g. collaborator)","example":"collaborator"}},"required":["type","id","url","entityId","preferredUsername"],"description":"Compact user profile for embedded contexts"},"InstagramLocation":{"type":"object","properties":{"type":{"type":"string","description":"ActivityStreams object type","example":"Place"},"id":{"type":"string","description":"Location ID","example":"213385402"},"name":{"type":"string","description":"Location name or country code","example":"Los Angeles, California"},"url":{"type":"string","format":"uri","description":"Location page URL","example":"https://www.instagram.com/explore/locations/213385402/"},"latitude":{"type":"number","description":"Geographic latitude","example":34.0522},"longitude":{"type":"number","description":"Geographic longitude","example":-118.2437}},"required":["type","name"],"description":"Geographic location"},"InstagramTag":{"type":"object","properties":{"type":{"type":"string","description":"ActivityStreams object type","example":"Tag"},"name":{"type":"string","description":"Tag name","example":"learnfromkhaby"},"href":{"type":"string","format":"uri","description":"Tag URL","example":"https://www.instagram.com/explore/tags/learnfromkhaby/"}},"required":["type","name","href"],"description":"Hashtag or user mention"},"InstagramAttachment":{"type":"object","properties":{"type":{"type":"string","description":"ActivityStreams object type","example":"Video"},"url":{"type":"array","items":{"type":"string","format":"uri"},"description":"Media download URLs","example":["https://scontent.cdninstagram.com/v/t50.2886-16/video.mp4"]},"mediaType":{"type":"string","description":"MIME type","example":"video/mp4"},"width":{"type":"integer","description":"Width in pixels","example":576},"height":{"type":"integer","description":"Height in pixels","example":1024}},"required":["type","url"],"description":"Media file attachment"},"InstagramImageWithDimensions":{"allOf":[{"$ref":"#/components/schemas/InstagramImage"},{"type":"object","properties":{"width":{"type":"integer","description":"Width in pixels","example":1080},"height":{"type":"integer","description":"Height in pixels","example":1920}}}],"description":"Image resource with optional dimensions"},"InstagramAudio":{"type":"object","properties":{"type":{"type":"string","description":"ActivityStreams object type","example":"Audio"},"id":{"type":"string","format":"uri","description":"Audio permalink","example":"https://www.instagram.com/reels/audio/293394603591002/"},"entityId":{"type":"string","description":"Platform-specific audio ID","example":"293394603591002"},"name":{"type":"string","description":"Track name","example":"Original audio"},"artist":{"type":"string","description":"Artist name","example":"khaby00"},"isOriginal":{"type":"boolean","description":"Whether audio is user-created vs a licensed track","example":true},"duration":{"type":"number","description":"Duration in seconds","example":85.216}},"required":["type","entityId","name","artist","isOriginal"],"description":"Audio track metadata"},"InstagramCarouselItem":{"type":"object","properties":{"type":{"type":"string","description":"ActivityStreams object type","example":"Image"},"entityId":{"type":"string","description":"Instagram internal media ID","example":"3214260996432123574"},"image":{"type":"array","items":{"$ref":"#/components/schemas/InstagramImageWithDimensions"},"description":"Item thumbnails"},"attachment":{"type":"array","items":{"$ref":"#/components/schemas/InstagramAttachment"},"description":"Media files"},"name":{"type":"string","description":"Alt text","example":"Photo of Khabane Lame"}},"required":["type","entityId"],"description":"Individual slide in a carousel post"},"InstagramHighlight":{"type":"object","properties":{"type":{"type":"string","description":"ActivityStreams object type","example":"OrderedCollection"},"id":{"type":"string","format":"uri","description":"Collection permalink","example":"https://www.instagram.com/stories/highlights/17890000000000001/"},"entityId":{"type":"string","description":"Instagram internal highlight ID","example":"highlight:17890000000000001"},"name":{"type":"string","description":"Collection name","example":"Best of 2025"},"image":{"type":"array","items":{"$ref":"#/components/schemas/InstagramImage"},"description":"Highlight cover images"},"totalItems":{"type":["integer","null"],"description":"Number of items in collection","example":42}},"required":["type","id","entityId","totalItems"],"description":"Story highlight collection"},"InstagramComment":{"type":"object","properties":{"type":{"type":"string","description":"ActivityStreams object type","example":"Note"},"id":{"type":"string","format":"uri","description":"Comment permalink","example":"https://www.instagram.com/p/CybWViruta1/c/17890000000000001/"},"entityId":{"type":"string","description":"Instagram internal comment ID","example":"17890000000000001"},"content":{"type":"string","description":"Comment text","example":"This man hasn't been in my fyp for so long"},"published":{"type":"string","format":"date-time","description":"Publication date in ISO 8601 format","example":"2026-02-27T20:37:38.000Z"},"likeCount":{"type":"integer","description":"Number of likes","example":93210},"replyCount":{"type":"integer","description":"Number of replies","example":12},"attributedTo":{"allOf":[{"$ref":"#/components/schemas/InstagramEmbeddedUser"},{"description":"Comment author"}]},"inReplyTo":{"type":"string","format":"uri","description":"Post permalink","example":"https://www.instagram.com/p/CybWViruta1/"}},"required":["type","id","entityId","content","likeCount","replyCount","attributedTo","inReplyTo"],"description":"Post comment"},"InstagramStoryItem":{"type":"object","properties":{"type":{"type":"string","description":"ActivityStreams object type","example":"Video"},"url":{"type":"string","format":"uri","description":"Story item permalink","example":"https://www.instagram.com/stories/highlights/18067016518767507/"},"entityId":{"type":"string","description":"Instagram internal media ID","example":"3214260996432123580"},"published":{"type":"string","format":"date-time","description":"Publication date in ISO 8601 format","example":"2026-02-27T18:36:42.000Z"},"summary":{"type":"string","description":"Accessibility caption","example":"Photo by Khabane Lame on March 13, 2026."},"isSponsored":{"type":"boolean","description":"Whether story is a paid partnership","example":false},"image":{"type":"array","items":{"$ref":"#/components/schemas/InstagramImageWithDimensions"},"description":"Story item images"},"attachment":{"type":"array","items":{"anyOf":[{"$ref":"#/components/schemas/InstagramAttachment"},{"$ref":"#/components/schemas/InstagramLink"}]},"description":"Media files and link stickers"},"duration":{"type":"number","description":"Duration in seconds","example":23},"attributedTo":{"allOf":[{"$ref":"#/components/schemas/InstagramEmbeddedUser"},{"description":"Story author"}]}},"required":["type","entityId"],"description":"Individual story item"},"XLink":{"type":"object","properties":{"type":{"type":"string","description":"ActivityStreams object type","example":"Link"},"href":{"type":"string","format":"uri","description":"Link URL","example":"https://t.co/examplelink"},"rel":{"type":"string","description":"Link relation hint","example":"preferred"}},"required":["type","href"],"description":"External link"},"XImage":{"type":"object","properties":{"type":{"type":"string","description":"ActivityStreams object type","example":"Image"},"url":{"type":"string","format":"uri","description":"Image URL","example":"https://pbs.twimg.com/amplify_video_thumb/2024515147692195840/img/t8ePmit3Wst1hxAM.jpg"},"width":{"type":"integer","description":"Width in pixels","example":1536},"height":{"type":"integer","description":"Height in pixels","example":2048}},"required":["type","url"],"description":"Profile picture"},"XPost":{"type":"object","properties":{"type":{"type":"string","description":"ActivityStreams object type","example":"Note"},"id":{"type":"string","format":"uri","description":"Post permalink","example":"https://x.com/KhabyLame/status/2024515585569083437"},"url":{"type":"string","format":"uri","description":"Post permalink","example":"https://x.com/KhabyLame/status/2024515585569083437"},"entityId":{"type":"string","description":"X post ID","example":"2024515585569083437"},"content":{"type":"string","description":"Comment text","example":"This man hasn't been in my fyp for so long"},"published":{"type":"string","format":"date-time","description":"Publication date in ISO 8601 format","example":"2026-02-27T20:37:38.000Z"},"likeCount":{"type":"integer","description":"Number of likes","example":93210},"replyCount":{"type":"integer","description":"Number of replies","example":96},"viewCount":{"type":"integer","description":"Number of views","example":10195},"repostCount":{"type":"integer","description":"Number of reposts/retweets","example":3},"quoteCount":{"type":"integer","description":"Number of quote posts","example":0},"saveCount":{"type":"integer","description":"Number of saves/bookmarks","example":3},"contentFormat":{"type":"string","description":"Content format (`post` for regular posts, `longform` for longer posts)","example":"longform"},"isEdited":{"type":"boolean","description":"Whether the post has been edited","example":false},"attributedTo":{"$ref":"#/components/schemas/XEmbeddedUser"},"inReplyTo":{"type":"string","format":"uri","description":"URL of parent content","example":"https://x.com/NISMO/status/2024100000000000000"},"quote":{"$ref":"#/components/schemas/XQuotedPost"},"image":{"type":"array","items":{"allOf":[{"$ref":"#/components/schemas/XImage"},{"description":"Image resource with optional dimensions"}]},"description":"Primary images and thumbnails"},"attachment":{"type":"array","items":{"$ref":"#/components/schemas/XPostAttachment"},"description":"Media, poll, and preview attachments"},"tag":{"type":"array","items":{"$ref":"#/components/schemas/XTag"},"description":"Hashtags and mentions"}},"required":["type","id","url","entityId","content","likeCount"],"description":"X post"},"XEmbeddedUser":{"type":"object","properties":{"type":{"type":"string","description":"ActivityStreams object type","example":"Person"},"id":{"type":"string","format":"uri","description":"Profile URL","example":"https://x.com/KhabyLame"},"url":{"type":"string","format":"uri","description":"Profile URL","example":"https://x.com/KhabyLame"},"entityId":{"type":"string","description":"X user ID","example":"221838349"},"preferredUsername":{"type":"string","description":"Username or handle","example":"KhabyLame"},"name":{"type":"string","description":"Display name","example":"Khabane Lame"},"icon":{"$ref":"#/components/schemas/XImage"},"isPrivate":{"type":"boolean","description":"Whether account is protected","example":false},"isVerified":{"type":"boolean","description":"Whether account has legacy verification","example":false},"isPaidVerified":{"type":"boolean","description":"Whether account has X Premium verification","example":true},"summary":{"type":"string","description":"Bio text","example":"Let's Go"},"attachment":{"type":"array","items":{"$ref":"#/components/schemas/XLink"},"description":"Profile links"},"followerCount":{"type":"integer","description":"Number of followers","example":372131},"followingCount":{"type":"integer","description":"Number of accounts followed","example":8},"likeCount":{"type":"integer","description":"Number of likes made by the user","example":60},"postCount":{"type":"integer","description":"Number of public posts","example":267},"mediaCount":{"type":"integer","description":"Number of media posts","example":242},"listedCount":{"type":"integer","description":"Number of public X Lists the account appears in","example":215},"location":{"type":"string","description":"User location","example":"Milan, Italy"}},"required":["type","id","url"],"description":"Post author"},"XQuotedPost":{"type":"object","properties":{"type":{"type":"string","description":"ActivityStreams object type","example":"Note"},"id":{"type":"string","format":"uri","description":"Quoted post permalink","example":"https://x.com/NISMO/status/2024100000000000000"},"url":{"type":"string","format":"uri","description":"Quoted post permalink","example":"https://x.com/NISMO/status/2024100000000000000"},"entityId":{"type":"string","description":"Quoted X post ID","example":"2024100000000000000"},"content":{"type":"string","description":"Comment text","example":"Ready for race week."},"published":{"type":"string","format":"date-time","description":"Publication date in ISO 8601 format","example":"2026-02-18T12:00:00.000Z"},"likeCount":{"type":"integer","description":"Number of likes","example":93210},"replyCount":{"type":"integer","description":"Number of replies","example":96},"contentFormat":{"type":"string","description":"Content format (`post` for regular posts, `longform` for longer posts)","example":"longform"},"attributedTo":{"allOf":[{"$ref":"#/components/schemas/XEmbeddedUser"},{"description":"Compact X profile for embedded contexts"}],"description":"Quoted post author"},"image":{"type":"array","items":{"allOf":[{"$ref":"#/components/schemas/XImage"},{"description":"Image resource with optional dimensions"}]},"description":"Primary images and thumbnails"},"attachment":{"type":"array","items":{"anyOf":[{"$ref":"#/components/schemas/XAttachment"},{"$ref":"#/components/schemas/XLinkAttachment"},{"$ref":"#/components/schemas/XArticleAttachment"},{"$ref":"#/components/schemas/XPollAttachment"}]},"description":"Quoted post attachments"}},"required":["type","id","url","entityId","content","likeCount"],"description":"Quoted post"},"XAttachment":{"type":"object","properties":{"type":{"type":"string","description":"ActivityStreams object type","example":"Video"},"url":{"type":"array","items":{"type":"string","format":"uri"},"description":"Media download URLs","example":["https://video.twimg.com/ext_tw_video/123/pu/vid/avc1/example.mp4"]},"mediaType":{"type":"string","description":"MIME type","example":"video/mp4"},"width":{"type":"integer","description":"Width in pixels","example":1280},"height":{"type":"integer","description":"Height in pixels","example":720},"bitrate":{"type":"integer","description":"Bitrate in bits per second","example":950000},"duration":{"type":"number","description":"Duration in seconds","example":16.266}},"required":["type","url"],"description":"Post media attachment"},"XLinkAttachment":{"type":"object","properties":{"type":{"type":"string","description":"ActivityStreams object type","example":"Link"},"href":{"type":"string","format":"uri","description":"Preview URL","example":"https://www.formulae.com/en/latest/article/nissan-and-khaby-lame-share-the-track-in-jeddah.3xexample"},"name":{"type":"string","description":"Preview title","example":"Nissan and Khaby Lame share the track in Jeddah"},"summary":{"type":"string","description":"Preview description","example":"A quick recap from Formula E race week in Jeddah."},"image":{"type":"array","items":{"allOf":[{"$ref":"#/components/schemas/XImage"},{"description":"Image resource with optional dimensions"}]},"description":"Preview images"}},"required":["type","href"],"description":"Link preview attachment"},"XArticleAttachment":{"type":"object","properties":{"type":{"type":"string","description":"ActivityStreams object type","example":"Article"},"entityId":{"type":"string","description":"X article ID","example":"1971521477247789275"},"url":{"type":"string","format":"uri","description":"Article URL","example":"https://www.formulae.com/en/latest/article/nissan-and-khaby-lame-share-the-track-in-jeddah.3xexample"},"name":{"type":"string","description":"Article title","example":"Nissan and Khaby Lame share the track in Jeddah"},"summary":{"type":"string","description":"Article preview text","example":"A quick recap from Formula E race week in Jeddah."},"image":{"type":"array","items":{"allOf":[{"$ref":"#/components/schemas/XImage"},{"description":"Image resource with optional dimensions"}]},"description":"Article cover images"}},"required":["type"],"description":"Article preview attachment"},"XPollAttachment":{"type":"object","properties":{"type":{"type":"string","description":"ActivityStreams object type","example":"Question"},"oneOf":{"type":"array","items":{"$ref":"#/components/schemas/XPollOption"},"minItems":2,"description":"Poll options"},"voterCount":{"type":"integer","description":"Total number of votes","example":194},"closed":{"type":"string","format":"date-time","description":"Poll closing time in ISO 8601 format","example":"2026-02-20T16:05:03.000Z"}},"required":["type","oneOf"],"description":"Poll attachment"},"XPollOption":{"type":"object","properties":{"type":{"type":"string","description":"ActivityStreams object type","example":"Note"},"name":{"type":"string","description":"Poll option label","example":"Nissan Formula E car"},"voteCount":{"type":"integer","description":"Number of votes for this option","example":128}},"required":["type","name"],"description":"Poll option"},"XPostAttachment":{"anyOf":[{"$ref":"#/components/schemas/XAttachment"},{"$ref":"#/components/schemas/XLinkAttachment"},{"$ref":"#/components/schemas/XArticleAttachment"},{"$ref":"#/components/schemas/XPollAttachment"}],"description":"Post attachment"},"XTag":{"type":"object","properties":{"type":{"type":"string","description":"ActivityStreams object type","example":"Tag"},"name":{"type":"string","description":"Tag name","example":"learnfromkhaby"},"href":{"type":"string","format":"uri","description":"Tag or mention URL","example":"https://x.com/hashtag/learnfromkhaby"}},"required":["type","name"],"description":"Hashtag or user mention"},"XCommunityRule":{"type":"object","properties":{"type":{"type":"string","description":"ActivityStreams object type","example":"Document"},"entityId":{"type":"string","description":"Platform-specific rule ID","example":"1848458992051159411"},"name":{"type":"string","description":"Rule title","example":"Post memes only"},"content":{"type":"string","description":"Rule description","example":"Posts should be memes. No unrelated content or spam."}},"required":["type","name"],"description":"Community rule"},"RedditImage":{"type":"object","properties":{"type":{"type":"string","description":"ActivityStreams object type","example":"Image"},"url":{"type":"string","format":"uri","description":"Image URL","example":"https://i.redd.it/post1.png"},"width":{"type":"integer","description":"Width in pixels","example":1200},"height":{"type":"integer","description":"Height in pixels","example":675}},"required":["type","url"],"description":"Profile picture"},"RedditPost":{"type":"object","properties":{"type":{"type":"string","enum":["Note"]},"id":{"type":"string","format":"uri","description":"Post permalink","example":"https://www.reddit.com/r/programming/comments/post_1/launch_day/"},"url":{"type":"string","format":"uri","description":"Post permalink","example":"https://www.reddit.com/r/programming/comments/post_1/launch_day/"},"entityId":{"type":"string","description":"Reddit post ID","example":"post_1"},"name":{"type":"string","description":"Post title","example":"Launch day"},"content":{"type":["string","null"],"description":"Post body text","example":"We shipped Reddit support."},"published":{"type":"string","format":"date-time","description":"Publication date in ISO 8601 format","example":"2026-02-27T20:37:38.000Z"},"isEdited":{"type":"boolean","description":"Whether the post has been edited","example":false},"isLocked":{"type":"boolean","description":"Whether the post is locked","example":false},"isOriginal":{"type":"boolean","description":"Whether the post is marked as original content","example":false},"isPinned":{"type":"boolean","description":"Whether the post is stickied","example":false},"isSponsored":{"type":"boolean","description":"Whether the post is promoted","example":false},"isAdult":{"type":"boolean","description":"Whether the post is marked as adult content","example":false},"isSpoiler":{"type":"boolean","description":"Whether the post is marked as a spoiler","example":false},"isSearchable":{"type":"boolean","description":"Whether the post is visible to search engines","example":true},"likeCount":{"type":"integer","description":"Number of likes","example":93210},"voteCount":{"type":"integer","description":"Net score","example":118},"commentCount":{"type":"integer","description":"Comment count","example":15},"shareCount":{"type":"integer","description":"Number of crossposts","example":8},"attributedTo":{"$ref":"#/components/schemas/RedditEmbeddedUser"},"icon":{"allOf":[{"$ref":"#/components/schemas/RedditImage"},{"description":"Thumbnail image"}]},"image":{"type":"array","items":{"allOf":[{"$ref":"#/components/schemas/RedditImage"},{"description":"Reddit image resource"}]},"description":"Preview image variants"},"attachment":{"type":"array","items":{"anyOf":[{"allOf":[{"$ref":"#/components/schemas/RedditImage"},{"description":"Reddit image resource"}]},{"$ref":"#/components/schemas/RedditVideoAttachment"},{"$ref":"#/components/schemas/RedditLinkAttachment"}]},"description":"Post attachments"},"tag":{"type":"array","items":{"$ref":"#/components/schemas/RedditTag"},"description":"Subreddit and flair tags"},"quote":{"$ref":"#/components/schemas/RedditQuotedPost"}},"required":["type","id","url","content","likeCount"],"description":"Reddit post"},"RedditEmbeddedUser":{"type":"object","properties":{"type":{"type":"string","enum":["Person"]},"id":{"type":"string","format":"uri","description":"Profile URL","example":"https://www.reddit.com/user/spez/"},"url":{"type":"string","format":"uri","description":"Profile URL","example":"https://www.reddit.com/user/spez/"},"entityId":{"type":"string","description":"Platform-specific entity ID","example":"t2_4x25quk"},"preferredUsername":{"type":"string","description":"Username or handle","example":"spez"},"name":{"type":"string","description":"Display name","example":"Steve Huffman"},"icon":{"$ref":"#/components/schemas/RedditImage"},"role":{"type":"string","description":"Role label for distinguished accounts","example":"admin"},"summary":{"type":"string","description":"User bio","example":"Reddit CEO"},"published":{"type":"string","format":"date-time","description":"Account creation date","example":"2005-12-08T07:46:43.000Z"},"isVerified":{"type":"boolean","description":"Whether the account is verified","example":true},"isEmployee":{"type":"boolean","description":"Whether the account belongs to a Reddit employee","example":true},"isMod":{"type":"boolean","description":"Whether the account is a moderator","example":false},"isPremium":{"type":"boolean","description":"Whether the account has a paid premium subscription","example":false},"isSearchable":{"type":"boolean","description":"Whether the profile is visible to search engines","example":true},"isFollowable":{"type":"boolean","description":"Whether the account can be followed","example":true},"isAdult":{"type":"boolean","description":"Whether the profile is marked as adult content","example":false},"score":{"type":"integer","description":"Total Reddit account score","example":999999},"postScore":{"type":"integer","description":"Score earned from Reddit posts","example":555555},"commentScore":{"type":"integer","description":"Score earned from Reddit comments","example":444444},"awarderScore":{"type":"integer","description":"Score earned from giving awards","example":123},"awardeeScore":{"type":"integer","description":"Score earned from receiving awards","example":321},"status":{"type":"string","description":"Account status","example":"active"},"image":{"allOf":[{"$ref":"#/components/schemas/RedditImage"},{"description":"Banner image"}]}},"required":["type","id","url"],"description":"Post author"},"RedditVideoAttachment":{"type":"object","properties":{"type":{"type":"string","enum":["Video"]},"url":{"type":"array","items":{"type":"string","format":"uri"},"description":"Media download URLs","example":["https://v.redd.it/abc123/DASH_720.mp4"]},"mediaType":{"type":"string","description":"MIME type","example":"video/mp4"},"width":{"type":"integer","description":"Width in pixels","example":576},"height":{"type":"integer","description":"Height in pixels","example":1024},"duration":{"type":"number","description":"Duration in seconds","example":15}},"required":["type","url"],"description":"Reddit video attachment"},"RedditLinkAttachment":{"type":"object","properties":{"type":{"type":"string","enum":["Link"]},"href":{"type":"string","format":"uri","description":"Linked URL","example":"https://example.com/article"},"name":{"type":"string","description":"Link title","example":"External article"},"summary":{"type":"string","description":"Link preview summary","example":"A quick summary from the linked article."}},"required":["type","href"],"description":"Outbound link attachment"},"RedditTag":{"type":"object","properties":{"type":{"type":"string","description":"ActivityStreams object type","example":"Tag"},"name":{"type":"string","description":"Tag name","example":"programming"},"href":{"type":"string","format":"uri","description":"Subreddit or flair URL","example":"https://www.reddit.com/r/programming/"}},"required":["type","name"],"description":"Reddit tag or flair"},"RedditQuotedPost":{"type":"object","properties":{"type":{"type":"string","enum":["Note"]},"id":{"type":"string","format":"uri","description":"Quoted post permalink","example":"https://www.reddit.com/r/programming/comments/post_1/launch_day/"},"url":{"type":"string","format":"uri","description":"Quoted post permalink","example":"https://www.reddit.com/r/programming/comments/post_1/launch_day/"},"entityId":{"type":"string","description":"Quoted Reddit post ID","example":"post_1"},"name":{"type":"string","description":"Quoted post title","example":"Launch day"},"content":{"type":["string","null"],"description":"Post body text","example":"We shipped Reddit support."},"published":{"type":"string","format":"date-time","description":"Publication date in ISO 8601 format","example":"2026-02-27T20:37:38.000Z"},"isEdited":{"type":"boolean","description":"Whether the post has been edited","example":false},"isLocked":{"type":"boolean","description":"Whether the post is locked","example":false},"isOriginal":{"type":"boolean","description":"Whether the post is marked as original content","example":false},"isPinned":{"type":"boolean","description":"Whether the post is stickied","example":false},"isSponsored":{"type":"boolean","description":"Whether the post is promoted","example":false},"isAdult":{"type":"boolean","description":"Whether the post is marked as adult content","example":false},"isSpoiler":{"type":"boolean","description":"Whether the post is marked as a spoiler","example":false},"isSearchable":{"type":"boolean","description":"Whether the post is visible to search engines","example":true},"likeCount":{"type":"integer","description":"Number of likes","example":93210},"voteCount":{"type":"integer","description":"Net score","example":118},"commentCount":{"type":"integer","description":"Comment count","example":15},"shareCount":{"type":"integer","description":"Number of crossposts","example":8},"attributedTo":{"allOf":[{"$ref":"#/components/schemas/RedditEmbeddedUser"},{"description":"Quoted post author"}]},"icon":{"allOf":[{"$ref":"#/components/schemas/RedditImage"},{"description":"Thumbnail image"}]},"image":{"type":"array","items":{"allOf":[{"$ref":"#/components/schemas/RedditImage"},{"description":"Reddit image resource"}]},"description":"Preview image variants"},"attachment":{"type":"array","items":{"anyOf":[{"allOf":[{"$ref":"#/components/schemas/RedditImage"},{"description":"Reddit image resource"}]},{"$ref":"#/components/schemas/RedditVideoAttachment"},{"$ref":"#/components/schemas/RedditLinkAttachment"}]},"description":"Post attachments"},"tag":{"type":"array","items":{"$ref":"#/components/schemas/RedditTag"},"description":"Subreddit and flair tags"}},"required":["type","id","url","content","likeCount"],"description":"Quoted or crossposted post"},"RedditComment":{"type":"object","properties":{"type":{"type":"string","enum":["Note"]},"id":{"type":"string","format":"uri","description":"Comment permalink","example":"https://www.reddit.com/r/programming/comments/post_1/launch_day/comment_1/"},"url":{"type":"string","format":"uri","description":"Comment permalink","example":"https://www.reddit.com/r/programming/comments/post_1/launch_day/comment_1/"},"entityId":{"type":"string","description":"Reddit comment ID","example":"comment_1"},"content":{"type":"string","description":"Comment text","example":"First!"},"published":{"type":"string","format":"date-time","description":"Publication date in ISO 8601 format","example":"2026-02-27T20:37:38.000Z"},"isPinned":{"type":"boolean","description":"Whether the comment is stickied","example":false},"isSponsored":{"type":"boolean","description":"Whether the comment is promoted","example":false},"hasReplies":{"type":"boolean","description":"Whether the comment has a replies listing available","example":true},"likeCount":{"type":"integer","description":"Number of likes","example":93210},"voteCount":{"type":"integer","description":"Net score","example":9},"attributedTo":{"allOf":[{"$ref":"#/components/schemas/RedditEmbeddedUser"},{"description":"Comment author"}]},"inReplyTo":{"type":"string","format":"uri","description":"Parent post or comment URL","example":"https://www.reddit.com/r/programming/comments/post_1/launch_day/"},"image":{"allOf":[{"$ref":"#/components/schemas/RedditImage"},{"description":"Primary comment image"}]},"attachment":{"type":"array","items":{"allOf":[{"$ref":"#/components/schemas/RedditImage"},{"description":"Reddit image resource"}]},"description":"Comment attachments"}},"required":["type","id","content","likeCount"],"description":"Reddit comment"},"RedditRule":{"type":"object","properties":{"type":{"type":"string","enum":["Document"],"description":"ActivityStreams object type","example":"Document"},"entityId":{"type":"string","description":"Platform-specific rule ID","example":"keep-it-civil"},"name":{"type":"string","description":"Rule title","example":"Keep it civil"},"content":{"type":"string","description":"Rule description","example":"Be respectful and avoid personal attacks."}},"required":["type","name"],"description":"Reddit community rule"},"RedditSubreddit":{"type":"object","properties":{"type":{"type":"string","enum":["Group"]},"id":{"type":"string","format":"uri","description":"Subreddit URL","example":"https://www.reddit.com/r/programming/"},"url":{"type":"string","format":"uri","description":"Subreddit URL","example":"https://www.reddit.com/r/programming/"},"entityId":{"type":"string","description":"Subreddit ID","example":"2fwo"},"slug":{"type":"string","description":"Subreddit slug without `r/`","example":"programming"},"name":{"type":"string","description":"Subreddit display title","example":"programming"},"summary":{"type":"string","description":"Short subreddit summary","example":"Subreddit dedicated to the news and discussions about the creation and use of technology and its surrounding issues."},"description":{"type":"string","description":"Long-form subreddit description","example":"/r/technology is a place to share and discuss the latest developments, happenings and curiosities in the world of technology."},"guidelines":{"type":"string","description":"Platform-provided community guidelines or posting guidance","example":"Please read the /r/technology sidebar for a list of our rules and guidelines."},"published":{"type":"string","format":"date-time","description":"Subreddit creation date","example":"2008-01-24T17:36:07.000Z"},"isAdult":{"type":"boolean","description":"Whether the subreddit is marked as adult content","example":false},"isSearchable":{"type":"boolean","description":"Whether the subreddit is discoverable in platform search and discovery surfaces","example":true},"category":{"type":"string","description":"Subreddit category","example":"Technology"},"memberCount":{"type":"integer","description":"Subscriber count","example":5000000},"icon":{"allOf":[{"$ref":"#/components/schemas/RedditImage"},{"description":"Community icon"}]},"image":{"allOf":[{"$ref":"#/components/schemas/RedditImage"},{"description":"Banner image"}]}},"required":["type","id","url","name"],"description":"Reddit subreddit"},"RedditUser":{"type":"object","properties":{"type":{"type":"string","enum":["Person"]},"id":{"type":"string","format":"uri","description":"Profile URL","example":"https://www.reddit.com/user/spez/"},"url":{"type":"string","format":"uri","description":"Profile URL","example":"https://www.reddit.com/user/spez/"},"entityId":{"type":"string","description":"Platform-specific entity ID","example":"t2_4x25quk"},"preferredUsername":{"type":"string","description":"Username or handle","example":"spez"},"name":{"type":"string","description":"Display name","example":"Steve Huffman"},"icon":{"$ref":"#/components/schemas/RedditImage"},"role":{"type":"string","description":"Role label for distinguished accounts","example":"admin"},"summary":{"type":"string","description":"User bio","example":"Reddit CEO"},"published":{"type":"string","format":"date-time","description":"Account creation date","example":"2005-12-08T07:46:43.000Z"},"isVerified":{"type":"boolean","description":"Whether the account is verified","example":true},"isEmployee":{"type":"boolean","description":"Whether the account belongs to a Reddit employee","example":true},"isMod":{"type":"boolean","description":"Whether the account is a moderator","example":false},"isPremium":{"type":"boolean","description":"Whether the account has a paid premium subscription","example":false},"isSearchable":{"type":"boolean","description":"Whether the profile is visible to search engines","example":true},"isFollowable":{"type":"boolean","description":"Whether the account can be followed","example":true},"isAdult":{"type":"boolean","description":"Whether the profile is marked as adult content","example":false},"score":{"type":"integer","description":"Total Reddit account score","example":999999},"postScore":{"type":"integer","description":"Score earned from Reddit posts","example":555555},"commentScore":{"type":"integer","description":"Score earned from Reddit comments","example":444444},"awarderScore":{"type":"integer","description":"Score earned from giving awards","example":123},"awardeeScore":{"type":"integer","description":"Score earned from receiving awards","example":321},"status":{"type":"string","description":"Account status","example":"active"},"image":{"allOf":[{"$ref":"#/components/schemas/RedditImage"},{"description":"Banner image"}]}},"required":["type","id","url"],"description":"Reddit user profile"},"LinkedInAddress":{"type":"object","properties":{"streetAddress":{"type":"string","example":"One Market Street"},"addressLocality":{"type":"string","example":"San Francisco"},"addressRegion":{"type":"string","example":"CA"},"postalCode":{"type":"string","example":"94105"},"addressCountry":{"type":"string","example":"US"}},"description":"Structured postal address","example":{"addressLocality":"United States","addressCountry":"US"}},"LinkedInImage":{"type":"object","properties":{"type":{"type":"string","description":"ActivityStreams object type","example":"Image"},"url":{"type":"string","format":"uri","description":"Image URL","example":"https://media.licdn.com/dms/image/v2/D4E03AQExample/profile-displayphoto-shrink_800_800/0/1700000000000"}},"required":["type","url"],"description":"Profile picture"},"LinkedInArticle":{"type":"object","properties":{"type":{"type":"string","description":"ActivityStreams object type","example":"Article"},"url":{"type":"string","format":"uri","description":"Article URL","example":"https://www.linkedin.com/pulse/can-you-outsource-taste-reid-hoffman-qcu3c"},"name":{"type":"string","description":"Article title","example":"Can you outsource taste?"},"image":{"type":"array","items":{"allOf":[{"$ref":"#/components/schemas/LinkedInImage"},{"description":"Image resource"}]},"description":"Article cover images","example":[{"type":"Image","url":"https://media.licdn.com/dms/image/v2/D5612AQF6uHExWXPl8Q/article-cover_image-shrink_720_1280/B56Z.u3RNSLAAQ-/0/1785345152512"}]},"likeCount":{"type":"integer","description":"Number of likes","example":257},"attributedTo":{"type":"object","properties":{"type":{"type":"string","description":"ActivityStreams object type","example":"Person"},"id":{"type":"string","format":"uri","description":"Author profile URL (stable identifier)","example":"https://www.linkedin.com/in/janedoe"},"url":{"type":"string","format":"uri","description":"Author profile URL","example":"https://www.linkedin.com/in/janedoe"},"name":{"type":"string","description":"Author display name","example":"Jane Doe"},"preferredUsername":{"type":"string","description":"Author username — looks the author up via GET /users/:username","example":"janedoe"},"followerCount":{"type":"integer","description":"Author follower count","example":12000}},"required":["type"],"description":"Article author","example":{"type":"Person","id":"https://www.linkedin.com/in/reidhoffman","url":"https://www.linkedin.com/in/reidhoffman","name":"Reid Hoffman","preferredUsername":"reidhoffman","followerCount":2783366}}},"required":["type"],"description":"Published LinkedIn article"},"LinkedInRecentPost":{"type":"object","properties":{"type":{"type":"string","description":"ActivityStreams object type","example":"Note"},"id":{"type":"string","format":"uri","description":"Post permalink (mirrors `url`, when present)","example":"https://www.linkedin.com/posts/reidhoffman_blake-scholl-is-leading-the-rebirth-of-american-activity-7486053762244079616-zWLl"},"url":{"type":"string","format":"uri","description":"Post URL","example":"https://www.linkedin.com/posts/reidhoffman_blake-scholl-is-leading-the-rebirth-of-american-activity-7486053762244079616-zWLl"},"entityId":{"type":"string","description":"Numeric activity ID, usable directly as :postId on GET /posts/:postId","example":"7486053762244079616"},"content":{"type":"string","description":"Comment text","example":"Blake Scholl is leading the rebirth of American Aerospace, powered by AI. He told me something that sounds like the nightmare scenario for AI and jobs: a thousand-person engine team reduced to two people."},"published":{"type":"string","format":"date-time","description":"Publication date in ISO 8601 format","example":"2026-07-23T13:45:01.045Z"},"likeCount":{"type":"integer","description":"Number of likes","example":191},"attributedTo":{"type":"object","properties":{"type":{"type":"string","description":"ActivityStreams object type","example":"Person"},"id":{"type":"string","format":"uri","description":"Author profile URL (stable identifier)","example":"https://www.linkedin.com/in/janedoe"},"url":{"type":"string","format":"uri","description":"Author profile URL","example":"https://www.linkedin.com/in/janedoe"},"name":{"type":"string","description":"Author display name","example":"Jane Doe"},"preferredUsername":{"type":"string","description":"Author username — looks the author up via GET /users/:username","example":"janedoe"},"followerCount":{"type":"integer","description":"Author follower count","example":12000}},"required":["type"],"description":"Post author","example":{"type":"Person","id":"https://www.linkedin.com/in/reidhoffman","url":"https://www.linkedin.com/in/reidhoffman","name":"Reid Hoffman","preferredUsername":"reidhoffman","followerCount":2783365}}},"required":["type","content"],"description":"Recent post or share embedded in a profile"},"LinkedInCompanyPost":{"type":"object","properties":{"type":{"type":"string","description":"ActivityStreams object type","example":"Note"},"id":{"type":"string","format":"uri","description":"Post URL","example":"https://www.linkedin.com/posts/stripe_new-providers-on-stripe-projects-are-available-activity-7483253516766109696-xCr3"},"url":{"type":"string","format":"uri","description":"Post URL","example":"https://www.linkedin.com/posts/stripe_new-providers-on-stripe-projects-are-available-activity-7483253516766109696-xCr3"},"entityId":{"type":"string","description":"Numeric activity ID, usable directly as :postId on GET /posts/:postId","example":"7483253516766109696"},"content":{"type":"string","description":"Comment text","example":"New providers on Stripe Projects are available now:\n\nChatbase\nComposio\nNodeOps\nCustomer.io\nDatadog"},"published":{"type":"string","format":"date-time","description":"Publication date in ISO 8601 format","example":"2026-07-15T20:17:50.459Z"},"likeCount":{"type":"integer","description":"Number of likes","example":93210},"attributedTo":{"type":"object","properties":{"type":{"type":"string","description":"ActivityStreams object type","example":"Person"},"id":{"type":"string","format":"uri","description":"Author profile URL (stable identifier)","example":"https://www.linkedin.com/in/janedoe"},"url":{"type":"string","format":"uri","description":"Author profile URL","example":"https://www.linkedin.com/in/janedoe"},"name":{"type":"string","description":"Author display name","example":"Jane Doe"},"preferredUsername":{"type":"string","description":"Author username — looks the author up via GET /users/:username","example":"janedoe"},"followerCount":{"type":"integer","description":"Author follower count","example":12000}},"required":["type"],"description":"Post author (the company)","example":{"type":"Organization","id":"https://www.linkedin.com/company/stripe","url":"https://www.linkedin.com/company/stripe","name":"Stripe","preferredUsername":"stripe"}}},"required":["type","id","url","content"],"description":"Company post. Some fields, like `published` and `likeCount`, may be absent on individual posts."},"LinkedInVideoAttachment":{"type":"object","properties":{"type":{"type":"string","description":"ActivityStreams object type","example":"Video"},"url":{"type":"array","items":{"type":"string","format":"uri"},"description":"Media download URLs","example":["https://dms.licdn.com/playlist/vid/v2/D4E05AQExample/mp4-720p-30fp-crf28/0/1700000000000"]},"mediaType":{"type":"string","description":"MIME type","example":"video/mp4"},"width":{"type":"integer","description":"Width in pixels","example":576},"height":{"type":"integer","description":"Height in pixels","example":1024},"duration":{"type":"number","description":"Duration in seconds","example":45},"preview":{"allOf":[{"$ref":"#/components/schemas/LinkedInImage"},{"description":"Video thumbnail","example":{"type":"Image","url":"https://media.licdn.com/dms/image/v2/D4E05AQExample/thumbnail.jpg"}}]}},"required":["type","url"],"description":"Post video attachment"},"LinkedInComment":{"type":"object","properties":{"type":{"type":"string","description":"ActivityStreams object type","example":"Note"},"content":{"type":"string","description":"Comment text","example":"Very excited to have Schematic in here and to be building with Stripe on this front!"},"published":{"type":"string","format":"date-time","description":"Publication date in ISO 8601 format","example":"2026-07-15T20:28:36.758Z"},"likeCount":{"type":"integer","description":"Number of likes","example":5},"attributedTo":{"type":"object","properties":{"type":{"type":"string","description":"ActivityStreams object type","example":"Person"},"id":{"type":"string","format":"uri","description":"Author profile URL (stable identifier)","example":"https://www.linkedin.com/in/janedoe"},"url":{"type":"string","format":"uri","description":"Author profile URL","example":"https://www.linkedin.com/in/janedoe"},"name":{"type":"string","description":"Author display name","example":"Jane Doe"},"preferredUsername":{"type":"string","description":"Author username — looks the author up via GET /users/:username","example":"janedoe"},"followerCount":{"type":"integer","description":"Author follower count","example":12000}},"required":["type"],"description":"Comment author","example":{"type":"Person","name":"Fynn Glover"}}},"required":["type","content"],"description":"Inline post comment"}},"parameters":{}},"paths":{"/v1/tiktok/users/{username}":{"get":{"operationId":"tiktokGetUser","tags":["TikTok"],"summary":"Get user profile","description":"Returns profile information for a TikTok user including bio, follower counts, verification status, and profile picture. Look up any public TikTok account by username.","parameters":[{"schema":{"type":"string","description":"TikTok username (with or without @ symbol)","example":"khaby.lame"},"required":true,"description":"TikTok username (with or without @ symbol)","name":"username","in":"path"}],"responses":{"200":{"description":"Returns the user details","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"@context":{"type":"array","prefixItems":[{"type":"string","enum":["https://www.w3.org/ns/activitystreams#"]},{"type":"string","enum":["https://konbiniapi.com/ns/social#"]}],"description":"ActivityStreams JSON-LD context","example":["https://www.w3.org/ns/activitystreams#","https://konbiniapi.com/ns/social#"]},"type":{"type":"string","description":"ActivityStreams object type","example":"Person"},"id":{"type":"string","format":"uri","description":"Profile URL","example":"https://www.tiktok.com/@khaby.lame"},"url":{"type":"string","format":"uri","description":"Profile URL","example":"https://www.tiktok.com/@khaby.lame"},"entityId":{"type":"string","description":"TikTok secUid","example":"MS4wLjABAAAAwAg0rSzO65WQfz4RzQgGv2Xdv108BgPXhRrrmNVIHQZ9PO8-flwwRtEppYTS0OjA"},"name":{"type":"string","description":"Display name","example":"Khabane Lame"},"preferredUsername":{"type":"string","description":"Username or handle","example":"khaby.lame"},"summary":{"type":"string","description":"Bio text","example":"Just a guy who reacts"},"attachment":{"type":"array","items":{"$ref":"#/components/schemas/TikTokLink"},"description":"External links in bio"},"published":{"type":"string","format":"date-time","description":"Account creation date in ISO 8601 format","example":"2020-03-15T00:00:00.000Z"},"isPrivate":{"type":"boolean","description":"Whether account is private","example":false},"isVerified":{"type":"boolean","description":"Whether account is verified","example":true},"isLive":{"type":"boolean","description":"Whether user is currently live streaming","example":false},"hasLikes":{"type":"boolean","description":"Whether user's liked videos are public","example":true},"hasPlaylists":{"type":"boolean","description":"Whether user has playlists","example":true},"followerCount":{"type":"integer","description":"Number of followers","example":160300000},"followingCount":{"type":"integer","description":"Number of accounts followed","example":85},"language":{"type":"string","description":"User language preference (BCP47 code)","example":"en"},"likeCount":{"type":"integer","description":"Total likes received across all content","example":2600000000},"likedCount":{"type":"integer","description":"Number of videos the user has liked","example":5300},"mediaCount":{"type":"integer","description":"Number of posts","example":1309},"icon":{"$ref":"#/components/schemas/TikTokImage","description":"User profile picture"},"image":{"type":"array","items":{"$ref":"#/components/schemas/TikTokImage"},"description":"Profile pictures in multiple sizes"}},"required":["@context","type","id","url","entityId","name","preferredUsername","isPrivate","isVerified","isLive","followerCount","followingCount","likeCount","mediaCount"]}},"required":["data"]}}}},"400":{"description":"Bad Request — Invalid parameters","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["validation_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Validation error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"401":{"description":"Unauthorized — Missing or invalid API key","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["missing_api_key","invalid_api_key"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Invalid API key","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"402":{"description":"Payment Required — Credits exhausted","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["credits_exhausted"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Credits exhausted. Upgrade your plan at konbiniapi.com","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"403":{"description":"Forbidden — API key disabled or expired","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["api_key_disabled","api_key_expired"],"description":"Machine-readable error code"},"message":{"type":"string","example":"API key is disabled","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"404":{"description":"Not Found","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["not_found","route_not_found"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Not found","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"413":{"description":"Content Too Large — Request body exceeds 1 MB","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["validation_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Request body too large","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"500":{"description":"Internal Server Error","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["internal_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Internal error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"502":{"description":"Bad Gateway — Upstream platform error","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["platform_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Platform error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"503":{"description":"Service Unavailable","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["service_unavailable"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Service unavailable","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"504":{"description":"Gateway Timeout — Upstream platform timed out","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["platform_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Platform error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}}}}},"/v1/tiktok/users/{username}/videos":{"get":{"operationId":"tiktokGetUserVideos","tags":["TikTok"],"summary":"Get user videos","description":"Returns a paginated list of videos from a user's profile. Supports sorting by newest, popular, or oldest. Maximum 35 videos per page.","parameters":[{"schema":{"type":"string","description":"TikTok username (with or without @ symbol)","example":"khaby.lame"},"required":true,"description":"TikTok username (with or without @ symbol)","name":"username","in":"path"},{"schema":{"type":"integer","minimum":1,"maximum":35,"default":35,"description":"Number of videos to fetch (maximum: 35)","example":35},"required":false,"description":"Number of videos to fetch (maximum: 35)","name":"count","in":"query"},{"schema":{"type":"string","default":"0","description":"Pagination cursor","example":"0"},"required":false,"description":"Pagination cursor","name":"cursor","in":"query"},{"schema":{"type":"string","enum":["newest","popular","oldest"],"default":"newest","description":"Sort order: newest (default), popular, or oldest","example":"newest"},"required":false,"description":"Sort order: newest (default), popular, or oldest","name":"order","in":"query"}],"responses":{"200":{"description":"Returns the user videos","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"@context":{"type":"array","prefixItems":[{"type":"string","enum":["https://www.w3.org/ns/activitystreams#"]},{"type":"string","enum":["https://konbiniapi.com/ns/social#"]}],"description":"ActivityStreams JSON-LD context","example":["https://www.w3.org/ns/activitystreams#","https://konbiniapi.com/ns/social#"]},"type":{"type":"string","description":"ActivityStreams collection type","example":"OrderedCollectionPage"},"partOf":{"type":"string","format":"uri","description":"URL of the full collection","example":"https://api.konbiniapi.com/v1/tiktok/users/khaby.lame/videos"},"totalItems":{"type":["integer","null"],"description":"Total number of items, null if unknown","example":1309},"cursor":{"type":["string","null"],"description":"Current page cursor, null on first page","example":null},"nextCursor":{"type":["string","null"],"description":"Cursor for the next page, null on last page","example":"1772217402000"},"next":{"type":["string","null"],"format":"uri","description":"URL for the next page, null on last page","example":"https://api.konbiniapi.com/v1/tiktok/users/khaby.lame/videos?cursor=1772217402000&count=30"},"itemCount":{"type":"integer","description":"Number of items returned in this page","example":30},"orderedItems":{"type":"array","items":{"$ref":"#/components/schemas/TikTokVideo"},"description":"Items in this page"}},"required":["@context","type","partOf","totalItems","cursor","nextCursor","next","itemCount","orderedItems"]}},"required":["data"]}}}},"400":{"description":"Bad Request — Invalid parameters","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["validation_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Validation error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"401":{"description":"Unauthorized — Missing or invalid API key","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["missing_api_key","invalid_api_key"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Invalid API key","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"402":{"description":"Payment Required — Credits exhausted","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["credits_exhausted"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Credits exhausted. Upgrade your plan at konbiniapi.com","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"403":{"description":"Forbidden — API key disabled or expired","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["api_key_disabled","api_key_expired"],"description":"Machine-readable error code"},"message":{"type":"string","example":"API key is disabled","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"404":{"description":"Not Found","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["not_found","route_not_found"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Not found","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"413":{"description":"Content Too Large — Request body exceeds 1 MB","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["validation_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Request body too large","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"500":{"description":"Internal Server Error","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["internal_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Internal error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"502":{"description":"Bad Gateway — Upstream platform error","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["platform_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Platform error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"503":{"description":"Service Unavailable","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["service_unavailable"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Service unavailable","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"504":{"description":"Gateway Timeout — Upstream platform timed out","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["platform_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Platform error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}}}}},"/v1/tiktok/users/{username}/likes":{"get":{"operationId":"tiktokGetUserLikes","tags":["TikTok"],"summary":"Get user liked videos","description":"Returns a paginated list of videos liked by a TikTok user. Note: Users may have their likes set to private, in which case an empty list will be returned.","parameters":[{"schema":{"type":"string","description":"TikTok username (with or without @ symbol)","example":"khaby.lame"},"required":true,"description":"TikTok username (with or without @ symbol)","name":"username","in":"path"},{"schema":{"type":"integer","minimum":1,"maximum":35,"default":35,"description":"Number of videos to fetch (maximum: 35)","example":35},"required":false,"description":"Number of videos to fetch (maximum: 35)","name":"count","in":"query"},{"schema":{"type":"string","default":"0","description":"Pagination cursor","example":"0"},"required":false,"description":"Pagination cursor","name":"cursor","in":"query"}],"responses":{"200":{"description":"Returns the user liked videos","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"@context":{"type":"array","prefixItems":[{"type":"string","enum":["https://www.w3.org/ns/activitystreams#"]},{"type":"string","enum":["https://konbiniapi.com/ns/social#"]}],"description":"ActivityStreams JSON-LD context","example":["https://www.w3.org/ns/activitystreams#","https://konbiniapi.com/ns/social#"]},"type":{"type":"string","description":"ActivityStreams collection type","example":"OrderedCollectionPage"},"partOf":{"type":"string","format":"uri","description":"URL of the full collection","example":"https://api.konbiniapi.com/v1/tiktok/users/khaby.lame/likes"},"totalItems":{"type":["integer","null"],"description":"Total number of items, null if unknown","example":1309},"cursor":{"type":["string","null"],"description":"Current page cursor, null on first page","example":null},"nextCursor":{"type":["string","null"],"description":"Cursor for the next page, null on last page","example":"1772217402000"},"next":{"type":["string","null"],"format":"uri","description":"URL for the next page, null on last page","example":"https://api.konbiniapi.com/v1/tiktok/users/khaby.lame/likes?cursor=1772217402000&count=30"},"itemCount":{"type":"integer","description":"Number of items returned in this page","example":30},"orderedItems":{"type":"array","items":{"$ref":"#/components/schemas/TikTokVideo"},"description":"Items in this page"}},"required":["@context","type","partOf","totalItems","cursor","nextCursor","next","itemCount","orderedItems"]}},"required":["data"]}}}},"400":{"description":"Bad Request — Invalid parameters","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["validation_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Validation error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"401":{"description":"Unauthorized — Missing or invalid API key","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["missing_api_key","invalid_api_key"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Invalid API key","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"402":{"description":"Payment Required — Credits exhausted","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["credits_exhausted"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Credits exhausted. Upgrade your plan at konbiniapi.com","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"403":{"description":"Forbidden — API key disabled or expired","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["api_key_disabled","api_key_expired"],"description":"Machine-readable error code"},"message":{"type":"string","example":"API key is disabled","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"404":{"description":"Not Found","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["not_found","route_not_found"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Not found","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"413":{"description":"Content Too Large — Request body exceeds 1 MB","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["validation_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Request body too large","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"500":{"description":"Internal Server Error","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["internal_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Internal error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"502":{"description":"Bad Gateway — Upstream platform error","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["platform_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Platform error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"503":{"description":"Service Unavailable","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["service_unavailable"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Service unavailable","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"504":{"description":"Gateway Timeout — Upstream platform timed out","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["platform_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Platform error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}}}}},"/v1/tiktok/users/{username}/reposts":{"get":{"operationId":"tiktokGetUserReposts","tags":["TikTok"],"summary":"Get user reposts","description":"Returns a paginated list of videos reposted by a TikTok user. Note: Users may have their reposts set to private, in which case an empty list will be returned.","parameters":[{"schema":{"type":"string","description":"TikTok username (with or without @ symbol)","example":"khaby.lame"},"required":true,"description":"TikTok username (with or without @ symbol)","name":"username","in":"path"},{"schema":{"type":"integer","minimum":1,"maximum":30,"default":30,"description":"Number of videos to fetch (maximum: 30)","example":30},"required":false,"description":"Number of videos to fetch (maximum: 30)","name":"count","in":"query"},{"schema":{"type":"string","default":"0","description":"Pagination cursor","example":"0"},"required":false,"description":"Pagination cursor","name":"cursor","in":"query"},{"schema":{"type":"string","enum":["newest","popular","oldest"],"default":"newest","description":"Sort order: newest (default), popular, or oldest","example":"newest"},"required":false,"description":"Sort order: newest (default), popular, or oldest","name":"order","in":"query"}],"responses":{"200":{"description":"Returns the user reposts","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"@context":{"type":"array","prefixItems":[{"type":"string","enum":["https://www.w3.org/ns/activitystreams#"]},{"type":"string","enum":["https://konbiniapi.com/ns/social#"]}],"description":"ActivityStreams JSON-LD context","example":["https://www.w3.org/ns/activitystreams#","https://konbiniapi.com/ns/social#"]},"type":{"type":"string","description":"ActivityStreams collection type","example":"OrderedCollectionPage"},"partOf":{"type":"string","format":"uri","description":"URL of the full collection","example":"https://api.konbiniapi.com/v1/tiktok/users/khaby.lame/reposts"},"totalItems":{"type":["integer","null"],"description":"Total number of items, null if unknown","example":1309},"cursor":{"type":["string","null"],"description":"Current page cursor, null on first page","example":null},"nextCursor":{"type":["string","null"],"description":"Cursor for the next page, null on last page","example":"1772217402000"},"next":{"type":["string","null"],"format":"uri","description":"URL for the next page, null on last page","example":"https://api.konbiniapi.com/v1/tiktok/users/khaby.lame/reposts?cursor=1772217402000&count=30"},"itemCount":{"type":"integer","description":"Number of items returned in this page","example":30},"orderedItems":{"type":"array","items":{"$ref":"#/components/schemas/TikTokVideo"},"description":"Items in this page"}},"required":["@context","type","partOf","totalItems","cursor","nextCursor","next","itemCount","orderedItems"]}},"required":["data"]}}}},"400":{"description":"Bad Request — Invalid parameters","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["validation_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Validation error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"401":{"description":"Unauthorized — Missing or invalid API key","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["missing_api_key","invalid_api_key"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Invalid API key","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"402":{"description":"Payment Required — Credits exhausted","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["credits_exhausted"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Credits exhausted. Upgrade your plan at konbiniapi.com","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"403":{"description":"Forbidden — API key disabled or expired","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["api_key_disabled","api_key_expired"],"description":"Machine-readable error code"},"message":{"type":"string","example":"API key is disabled","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"404":{"description":"Not Found","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["not_found","route_not_found"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Not found","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"413":{"description":"Content Too Large — Request body exceeds 1 MB","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["validation_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Request body too large","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"500":{"description":"Internal Server Error","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["internal_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Internal error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"502":{"description":"Bad Gateway — Upstream platform error","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["platform_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Platform error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"503":{"description":"Service Unavailable","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["service_unavailable"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Service unavailable","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"504":{"description":"Gateway Timeout — Upstream platform timed out","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["platform_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Platform error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}}}}},"/v1/tiktok/users/{username}/collections":{"get":{"operationId":"tiktokGetUserCollections","tags":["TikTok"],"summary":"Get user collections","description":"Returns a paginated list of video collections (playlists and mixes) on a TikTok user's profile. Includes collection name, cover image, and video count.","parameters":[{"schema":{"type":"string","description":"TikTok username (with or without @ symbol)","example":"khaby.lame"},"required":true,"description":"TikTok username (with or without @ symbol)","name":"username","in":"path"},{"schema":{"type":"integer","minimum":1,"maximum":30,"default":30,"description":"Number of collections to fetch (maximum: 30)","example":30},"required":false,"description":"Number of collections to fetch (maximum: 30)","name":"count","in":"query"},{"schema":{"type":"string","default":"0","description":"Pagination cursor","example":"0"},"required":false,"description":"Pagination cursor","name":"cursor","in":"query"}],"responses":{"200":{"description":"Returns the user collections","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"@context":{"type":"array","prefixItems":[{"type":"string","enum":["https://www.w3.org/ns/activitystreams#"]},{"type":"string","enum":["https://konbiniapi.com/ns/social#"]}],"description":"ActivityStreams JSON-LD context","example":["https://www.w3.org/ns/activitystreams#","https://konbiniapi.com/ns/social#"]},"type":{"type":"string","description":"ActivityStreams collection type","example":"OrderedCollectionPage"},"partOf":{"type":"string","format":"uri","description":"URL of the full collection","example":"https://api.konbiniapi.com/v1/tiktok/users/khaby.lame/collections"},"totalItems":{"type":["integer","null"],"description":"Total number of items, null if unknown","example":1309},"cursor":{"type":["string","null"],"description":"Current page cursor, null on first page","example":null},"nextCursor":{"type":["string","null"],"description":"Cursor for the next page, null on last page","example":"1772217402000"},"next":{"type":["string","null"],"format":"uri","description":"URL for the next page, null on last page","example":"https://api.konbiniapi.com/v1/tiktok/users/khaby.lame/collections?cursor=1772217402000&count=30"},"itemCount":{"type":"integer","description":"Number of items returned in this page","example":30},"orderedItems":{"type":"array","items":{"$ref":"#/components/schemas/TikTokCollection"},"description":"Items in this page"}},"required":["@context","type","partOf","totalItems","cursor","nextCursor","next","itemCount","orderedItems"]}},"required":["data"]}}}},"400":{"description":"Bad Request — Invalid parameters","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["validation_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Validation error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"401":{"description":"Unauthorized — Missing or invalid API key","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["missing_api_key","invalid_api_key"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Invalid API key","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"402":{"description":"Payment Required — Credits exhausted","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["credits_exhausted"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Credits exhausted. Upgrade your plan at konbiniapi.com","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"403":{"description":"Forbidden — API key disabled or expired","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["api_key_disabled","api_key_expired"],"description":"Machine-readable error code"},"message":{"type":"string","example":"API key is disabled","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"404":{"description":"Not Found","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["not_found","route_not_found"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Not found","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"413":{"description":"Content Too Large — Request body exceeds 1 MB","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["validation_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Request body too large","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"500":{"description":"Internal Server Error","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["internal_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Internal error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"502":{"description":"Bad Gateway — Upstream platform error","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["platform_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Platform error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"503":{"description":"Service Unavailable","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["service_unavailable"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Service unavailable","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"504":{"description":"Gateway Timeout — Upstream platform timed out","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["platform_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Platform error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}}}}},"/v1/tiktok/users/{username}/stories":{"get":{"operationId":"tiktokGetUserStories","tags":["TikTok"],"summary":"Get user stories","description":"Returns a paginated list of active stories for a TikTok user. Stories expire after 24 hours and include both images and videos with engagement data.","parameters":[{"schema":{"type":"string","description":"TikTok username (with or without @ symbol)","example":"khaby.lame"},"required":true,"description":"TikTok username (with or without @ symbol)","name":"username","in":"path"},{"schema":{"type":"integer","minimum":1,"maximum":35,"default":4,"description":"Number of stories to fetch (maximum: 35)","example":4},"required":false,"description":"Number of stories to fetch (maximum: 35)","name":"count","in":"query"},{"schema":{"type":"string","default":"0","description":"Pagination cursor","example":"0"},"required":false,"description":"Pagination cursor","name":"cursor","in":"query"}],"responses":{"200":{"description":"Returns the user stories","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"@context":{"type":"array","prefixItems":[{"type":"string","enum":["https://www.w3.org/ns/activitystreams#"]},{"type":"string","enum":["https://konbiniapi.com/ns/social#"]}],"description":"ActivityStreams JSON-LD context","example":["https://www.w3.org/ns/activitystreams#","https://konbiniapi.com/ns/social#"]},"type":{"type":"string","description":"ActivityStreams collection type","example":"OrderedCollectionPage"},"partOf":{"type":"string","format":"uri","description":"URL of the full collection","example":"https://api.konbiniapi.com/v1/tiktok/users/khaby.lame/stories"},"totalItems":{"type":["integer","null"],"description":"Total number of items, null if unknown","example":1309},"cursor":{"type":["string","null"],"description":"Current page cursor, null on first page","example":null},"nextCursor":{"type":["string","null"],"description":"Cursor for the next page, null on last page","example":"1772217402000"},"next":{"type":["string","null"],"format":"uri","description":"URL for the next page, null on last page","example":"https://api.konbiniapi.com/v1/tiktok/users/khaby.lame/stories?cursor=1772217402000&count=30"},"itemCount":{"type":"integer","description":"Number of items returned in this page","example":30},"orderedItems":{"type":"array","items":{"$ref":"#/components/schemas/TikTokStory"},"description":"Items in this page"}},"required":["@context","type","partOf","totalItems","cursor","nextCursor","next","itemCount","orderedItems"]}},"required":["data"]}}}},"400":{"description":"Bad Request — Invalid parameters","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["validation_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Validation error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"401":{"description":"Unauthorized — Missing or invalid API key","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["missing_api_key","invalid_api_key"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Invalid API key","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"402":{"description":"Payment Required — Credits exhausted","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["credits_exhausted"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Credits exhausted. Upgrade your plan at konbiniapi.com","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"403":{"description":"Forbidden — API key disabled or expired","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["api_key_disabled","api_key_expired"],"description":"Machine-readable error code"},"message":{"type":"string","example":"API key is disabled","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"404":{"description":"Not Found","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["not_found","route_not_found"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Not found","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"413":{"description":"Content Too Large — Request body exceeds 1 MB","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["validation_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Request body too large","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"500":{"description":"Internal Server Error","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["internal_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Internal error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"502":{"description":"Bad Gateway — Upstream platform error","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["platform_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Platform error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"503":{"description":"Service Unavailable","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["service_unavailable"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Service unavailable","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"504":{"description":"Gateway Timeout — Upstream platform timed out","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["platform_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Platform error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}}}}},"/v1/tiktok/users/{username}/following":{"get":{"operationId":"tiktokGetUserFollowing","tags":["TikTok"],"summary":"Get user following list","description":"Returns a paginated list of accounts a TikTok user follows. Maximum 30 per page. Includes profile details for each followed account.","parameters":[{"schema":{"type":"string","description":"TikTok username (with or without @ symbol)","example":"khaby.lame"},"required":true,"description":"TikTok username (with or without @ symbol)","name":"username","in":"path"},{"schema":{"type":"integer","minimum":1,"maximum":30,"default":30,"description":"Number of users to fetch (maximum: 30)","example":30},"required":false,"description":"Number of users to fetch (maximum: 30)","name":"count","in":"query"},{"schema":{"type":"string","default":"0","description":"Pagination cursor","example":"0"},"required":false,"description":"Pagination cursor","name":"cursor","in":"query"}],"responses":{"200":{"description":"Returns the user following list","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"@context":{"type":"array","prefixItems":[{"type":"string","enum":["https://www.w3.org/ns/activitystreams#"]},{"type":"string","enum":["https://konbiniapi.com/ns/social#"]}],"description":"ActivityStreams JSON-LD context","example":["https://www.w3.org/ns/activitystreams#","https://konbiniapi.com/ns/social#"]},"type":{"type":"string","description":"ActivityStreams collection type","example":"OrderedCollectionPage"},"partOf":{"type":"string","format":"uri","description":"URL of the full collection","example":"https://api.konbiniapi.com/v1/tiktok/users/khaby.lame/following"},"totalItems":{"type":["integer","null"],"description":"Total number of items, null if unknown","example":1309},"cursor":{"type":["string","null"],"description":"Current page cursor, null on first page","example":null},"nextCursor":{"type":["string","null"],"description":"Cursor for the next page, null on last page","example":"1772217402000"},"next":{"type":["string","null"],"format":"uri","description":"URL for the next page, null on last page","example":"https://api.konbiniapi.com/v1/tiktok/users/khaby.lame/following?cursor=1772217402000&count=30"},"itemCount":{"type":"integer","description":"Number of items returned in this page","example":30},"orderedItems":{"type":"array","items":{"$ref":"#/components/schemas/TikTokEmbeddedUser"},"description":"Items in this page"}},"required":["@context","type","partOf","totalItems","cursor","nextCursor","next","itemCount","orderedItems"]}},"required":["data"]}}}},"400":{"description":"Bad Request — Invalid parameters","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["validation_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Validation error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"401":{"description":"Unauthorized — Missing or invalid API key","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["missing_api_key","invalid_api_key"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Invalid API key","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"402":{"description":"Payment Required — Credits exhausted","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["credits_exhausted"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Credits exhausted. Upgrade your plan at konbiniapi.com","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"403":{"description":"Forbidden — API key disabled or expired","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["api_key_disabled","api_key_expired"],"description":"Machine-readable error code"},"message":{"type":"string","example":"API key is disabled","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"404":{"description":"Not Found","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["not_found","route_not_found"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Not found","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"413":{"description":"Content Too Large — Request body exceeds 1 MB","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["validation_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Request body too large","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"500":{"description":"Internal Server Error","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["internal_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Internal error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"502":{"description":"Bad Gateway — Upstream platform error","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["platform_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Platform error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"503":{"description":"Service Unavailable","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["service_unavailable"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Service unavailable","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"504":{"description":"Gateway Timeout — Upstream platform timed out","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["platform_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Platform error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}}}}},"/v1/tiktok/users/{username}/followers":{"get":{"operationId":"tiktokGetUserFollowers","tags":["TikTok"],"summary":"Get user followers list","description":"Returns a paginated list of accounts following a TikTok user. Maximum 30 per page. Includes profile details for each follower account.","parameters":[{"schema":{"type":"string","description":"TikTok username (with or without @ symbol)","example":"khaby.lame"},"required":true,"description":"TikTok username (with or without @ symbol)","name":"username","in":"path"},{"schema":{"type":"integer","minimum":1,"maximum":30,"default":30,"description":"Number of users to fetch (maximum: 30)","example":30},"required":false,"description":"Number of users to fetch (maximum: 30)","name":"count","in":"query"},{"schema":{"type":"string","default":"0","description":"Pagination cursor","example":"0"},"required":false,"description":"Pagination cursor","name":"cursor","in":"query"}],"responses":{"200":{"description":"Returns the user followers list","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"@context":{"type":"array","prefixItems":[{"type":"string","enum":["https://www.w3.org/ns/activitystreams#"]},{"type":"string","enum":["https://konbiniapi.com/ns/social#"]}],"description":"ActivityStreams JSON-LD context","example":["https://www.w3.org/ns/activitystreams#","https://konbiniapi.com/ns/social#"]},"type":{"type":"string","description":"ActivityStreams collection type","example":"OrderedCollectionPage"},"partOf":{"type":"string","format":"uri","description":"URL of the full collection","example":"https://api.konbiniapi.com/v1/tiktok/users/khaby.lame/followers"},"totalItems":{"type":["integer","null"],"description":"Total number of items, null if unknown","example":1309},"cursor":{"type":["string","null"],"description":"Current page cursor, null on first page","example":null},"nextCursor":{"type":["string","null"],"description":"Cursor for the next page, null on last page","example":"1772217402000"},"next":{"type":["string","null"],"format":"uri","description":"URL for the next page, null on last page","example":"https://api.konbiniapi.com/v1/tiktok/users/khaby.lame/followers?cursor=1772217402000&count=30"},"itemCount":{"type":"integer","description":"Number of items returned in this page","example":30},"orderedItems":{"type":"array","items":{"$ref":"#/components/schemas/TikTokEmbeddedUser"},"description":"Items in this page"}},"required":["@context","type","partOf","totalItems","cursor","nextCursor","next","itemCount","orderedItems"]}},"required":["data"]}}}},"400":{"description":"Bad Request — Invalid parameters","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["validation_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Validation error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"401":{"description":"Unauthorized — Missing or invalid API key","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["missing_api_key","invalid_api_key"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Invalid API key","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"402":{"description":"Payment Required — Credits exhausted","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["credits_exhausted"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Credits exhausted. Upgrade your plan at konbiniapi.com","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"403":{"description":"Forbidden — API key disabled or expired","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["api_key_disabled","api_key_expired"],"description":"Machine-readable error code"},"message":{"type":"string","example":"API key is disabled","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"404":{"description":"Not Found","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["not_found","route_not_found"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Not found","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"413":{"description":"Content Too Large — Request body exceeds 1 MB","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["validation_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Request body too large","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"500":{"description":"Internal Server Error","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["internal_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Internal error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"502":{"description":"Bad Gateway — Upstream platform error","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["platform_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Platform error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"503":{"description":"Service Unavailable","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["service_unavailable"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Service unavailable","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"504":{"description":"Gateway Timeout — Upstream platform timed out","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["platform_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Platform error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}}}}},"/v1/tiktok/users/{username}/live":{"get":{"operationId":"tiktokGetUserLive","tags":["TikTok"],"summary":"Get user live stream","description":"Returns the current live stream for a user, including stream URLs and viewer count. Returns 404 if the user is not currently live.","parameters":[{"schema":{"type":"string","description":"TikTok username (with or without @ symbol)","example":"khaby.lame"},"required":true,"description":"TikTok username (with or without @ symbol)","name":"username","in":"path"}],"responses":{"200":{"description":"Returns the live stream details","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"@context":{"type":"array","prefixItems":[{"type":"string","enum":["https://www.w3.org/ns/activitystreams#"]},{"type":"string","enum":["https://konbiniapi.com/ns/social#"]}],"description":"ActivityStreams JSON-LD context","example":["https://www.w3.org/ns/activitystreams#","https://konbiniapi.com/ns/social#"]},"type":{"type":"string","description":"ActivityStreams object type","example":"Video"},"id":{"type":"string","format":"uri","description":"Live stream permalink","example":"https://www.tiktok.com/@khaby.lame/live"},"url":{"type":"string","format":"uri","description":"Live stream URL","example":"https://www.tiktok.com/@khaby.lame/live"},"entityId":{"type":"string","description":"TikTok internal room ID","example":"7600000000000000001"},"published":{"type":"string","format":"date-time","description":"Publication date in ISO 8601 format","example":"2026-02-27T18:36:42.000Z"},"isLive":{"type":"boolean","description":"Whether stream is currently live","example":true},"viewCount":{"type":"integer","description":"Number of views","example":42600000},"viewerCount":{"type":"integer","description":"Current number of viewers","example":15000},"content":{"type":"string","description":"Caption or description","example":"When you realize there is a simpler way #learnfromkhaby"},"attributedTo":{"allOf":[{"$ref":"#/components/schemas/TikTokEmbeddedUser"},{"description":"Stream host"}]},"image":{"type":"array","items":{"$ref":"#/components/schemas/TikTokImage"},"description":"Stream cover images"},"attachment":{"type":"array","items":{"$ref":"#/components/schemas/TikTokLiveStreamAttachment"},"description":"Stream media sources"}},"required":["@context","type","id","url","entityId","isLive","attributedTo"]}},"required":["data"]}}}},"400":{"description":"Bad Request — Invalid parameters","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["validation_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Validation error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"401":{"description":"Unauthorized — Missing or invalid API key","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["missing_api_key","invalid_api_key"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Invalid API key","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"402":{"description":"Payment Required — Credits exhausted","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["credits_exhausted"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Credits exhausted. Upgrade your plan at konbiniapi.com","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"403":{"description":"Forbidden — API key disabled or expired","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["api_key_disabled","api_key_expired"],"description":"Machine-readable error code"},"message":{"type":"string","example":"API key is disabled","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"404":{"description":"Not Found","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["not_found","route_not_found"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Not found","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"413":{"description":"Content Too Large — Request body exceeds 1 MB","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["validation_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Request body too large","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"500":{"description":"Internal Server Error","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["internal_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Internal error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"502":{"description":"Bad Gateway — Upstream platform error","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["platform_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Platform error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"503":{"description":"Service Unavailable","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["service_unavailable"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Service unavailable","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"504":{"description":"Gateway Timeout — Upstream platform timed out","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["platform_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Platform error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}}}}},"/v1/tiktok/videos/{videoId}":{"get":{"operationId":"tiktokGetVideo","tags":["TikTok"],"summary":"Get video details","description":"Returns details for a single TikTok video including engagement counts, media files in multiple qualities, audio track, author info, and hashtags.","parameters":[{"schema":{"type":"string","description":"TikTok video ID","example":"7611615657754381599"},"required":true,"description":"TikTok video ID","name":"videoId","in":"path"}],"responses":{"200":{"description":"Returns the video details","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"@context":{"type":"array","prefixItems":[{"type":"string","enum":["https://www.w3.org/ns/activitystreams#"]},{"type":"string","enum":["https://konbiniapi.com/ns/social#"]}],"description":"ActivityStreams JSON-LD context","example":["https://www.w3.org/ns/activitystreams#","https://konbiniapi.com/ns/social#"]},"type":{"type":"string","description":"ActivityStreams object type","example":"Video"},"id":{"type":"string","format":"uri","description":"Video permalink","example":"https://www.tiktok.com/@khaby.lame/video/7611615657754381599"},"url":{"type":"string","format":"uri","description":"Video URL","example":"https://www.tiktok.com/@khaby.lame/video/7611615657754381599"},"entityId":{"type":"string","description":"TikTok internal video ID","example":"7611615657754381599"},"content":{"type":"string","description":"Caption or description","example":"When you realize there is a simpler way #learnfromkhaby"},"published":{"type":"string","format":"date-time","description":"Publication date in ISO 8601 format","example":"2026-02-27T18:36:42.000Z"},"duration":{"type":"number","description":"Duration in seconds","example":23},"viewCount":{"type":"integer","description":"Number of views","example":42600000},"likeCount":{"type":"integer","description":"Number of likes","example":2800000},"commentCount":{"type":"integer","description":"Number of comments","example":29200},"repostCount":{"type":"integer","description":"Number of reposts","example":0},"shareCount":{"type":"integer","description":"Number of shares","example":157700},"saveCount":{"type":"integer","description":"Number of saves","example":153238},"language":{"type":"string","description":"Content language (BCP47 code)","example":"en"},"isSponsored":{"type":"boolean","description":"Whether the video is a promoted ad","example":false},"location":{"type":"object","properties":{"type":{"type":"string","description":"ActivityStreams object type","example":"Place"},"id":{"type":"string","description":"Location ID","example":"213385402"},"name":{"type":"string","description":"Location name or country code","example":"Los Angeles, California"},"url":{"type":"string","format":"uri","description":"Location page URL"},"latitude":{"type":"number","description":"Geographic latitude","example":34.0522},"longitude":{"type":"number","description":"Geographic longitude","example":-118.2437}},"required":["type","name"],"description":"Location where the video was created","example":{"type":"Place","name":"US"}},"tag":{"type":"array","items":{"$ref":"#/components/schemas/TikTokTag"},"description":"Hashtags and mentions"},"attributedTo":{"$ref":"#/components/schemas/TikTokEmbeddedUser","description":"Video creator"},"attachment":{"type":"array","items":{"$ref":"#/components/schemas/TikTokVideoAttachment"},"description":"Video files in multiple qualities"},"image":{"type":"array","items":{"$ref":"#/components/schemas/TikTokImage"},"description":"Video thumbnails"},"preview":{"allOf":[{"$ref":"#/components/schemas/TikTokImage"},{"description":"Animated preview thumbnail"}]},"audio":{"$ref":"#/components/schemas/TikTokAudio","description":"Video audio track"}},"required":["@context","type","id","url","entityId","published","viewCount","likeCount","commentCount","repostCount","shareCount","saveCount","attributedTo"]}},"required":["data"]}}}},"400":{"description":"Bad Request — Invalid parameters","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["validation_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Validation error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"401":{"description":"Unauthorized — Missing or invalid API key","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["missing_api_key","invalid_api_key"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Invalid API key","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"402":{"description":"Payment Required — Credits exhausted","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["credits_exhausted"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Credits exhausted. Upgrade your plan at konbiniapi.com","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"403":{"description":"Forbidden — API key disabled or expired","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["api_key_disabled","api_key_expired"],"description":"Machine-readable error code"},"message":{"type":"string","example":"API key is disabled","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"404":{"description":"Not Found","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["not_found","route_not_found"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Not found","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"413":{"description":"Content Too Large — Request body exceeds 1 MB","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["validation_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Request body too large","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"500":{"description":"Internal Server Error","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["internal_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Internal error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"502":{"description":"Bad Gateway — Upstream platform error","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["platform_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Platform error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"503":{"description":"Service Unavailable","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["service_unavailable"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Service unavailable","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"504":{"description":"Gateway Timeout — Upstream platform timed out","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["platform_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Platform error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}}}}},"/v1/tiktok/videos/{videoId}/download":{"get":{"operationId":"tiktokGetVideoDownloadUrl","tags":["TikTok"],"summary":"Get video download URL","description":"Returns a video file URL you can download directly with a plain GET request — no cookies, no auth headers, no browser fingerprinting needed on your end. Not permanent, only valid for a few hours.","parameters":[{"schema":{"type":"string","description":"TikTok video ID","example":"7611615657754381599"},"required":true,"description":"TikTok video ID","name":"videoId","in":"path"},{"schema":{"type":"string","format":"uri","description":"Optional: an `aweme/v1/play/` URL copied from a prior video detail response for this same video. Providing it lets this endpoint skip re-fetching the video detail internally.","example":"https://www.tiktok.com/aweme/v1/play/?faid=1988&file_id=31d1120d6158449ca81efc56a01019fd&is_play_url=1&item_id=7355612345678901234&line=0&ply_type=2&signaturev3=dmlkZW9faWQ7ZmlsZV9pZDtpdGVtX2lkLjRjY2U1ZTlmYThkMjkzNGM1YmI0ZjE1ZWExYmFiODg4&tk=tt_chain_token&video_id=v26044gc0000d7q9k37og65t8l3poah0"},"required":false,"description":"Optional: an `aweme/v1/play/` URL copied from a prior video detail response for this same video. Providing it lets this endpoint skip re-fetching the video detail internally.","name":"url","in":"query"}],"responses":{"200":{"description":"Downloadable video file link","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/TikTokVideoDownloadUrl"}},"required":["data"]}}}},"400":{"description":"Bad Request — Invalid parameters","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["validation_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Validation error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"401":{"description":"Unauthorized — Missing or invalid API key","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["missing_api_key","invalid_api_key"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Invalid API key","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"402":{"description":"Payment Required — Credits exhausted","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["credits_exhausted"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Credits exhausted. Upgrade your plan at konbiniapi.com","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"403":{"description":"Forbidden — API key disabled or expired","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["api_key_disabled","api_key_expired"],"description":"Machine-readable error code"},"message":{"type":"string","example":"API key is disabled","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"404":{"description":"Not Found","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["not_found","route_not_found"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Not found","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"413":{"description":"Content Too Large — Request body exceeds 1 MB","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["validation_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Request body too large","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"500":{"description":"Internal Server Error","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["internal_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Internal error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"502":{"description":"Bad Gateway — Upstream platform error","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["platform_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Platform error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"503":{"description":"Service Unavailable","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["service_unavailable"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Service unavailable","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"504":{"description":"Gateway Timeout — Upstream platform timed out","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["platform_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Platform error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}}}}},"/v1/tiktok/videos/{videoId}/comments":{"get":{"operationId":"tiktokGetVideoComments","tags":["TikTok"],"summary":"Get video comments","description":"Returns a paginated list of top-level comments on a video. Maximum 50 per page. Use the replies endpoint to fetch threaded replies.","parameters":[{"schema":{"type":"string","description":"TikTok video ID","example":"7611615657754381599"},"required":true,"description":"TikTok video ID","name":"videoId","in":"path"},{"schema":{"type":"integer","minimum":1,"maximum":50,"default":20,"description":"Number of comments to fetch (maximum: 50)","example":20},"required":false,"description":"Number of comments to fetch (maximum: 50)","name":"count","in":"query"},{"schema":{"type":"string","default":"0","description":"Pagination cursor","example":"0"},"required":false,"description":"Pagination cursor","name":"cursor","in":"query"}],"responses":{"200":{"description":"Returns the video comments","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"@context":{"type":"array","prefixItems":[{"type":"string","enum":["https://www.w3.org/ns/activitystreams#"]},{"type":"string","enum":["https://konbiniapi.com/ns/social#"]}],"description":"ActivityStreams JSON-LD context","example":["https://www.w3.org/ns/activitystreams#","https://konbiniapi.com/ns/social#"]},"type":{"type":"string","description":"ActivityStreams collection type","example":"OrderedCollectionPage"},"partOf":{"type":"string","format":"uri","description":"URL of the full collection","example":"https://api.konbiniapi.com/v1/tiktok/videos/7611615657754381599/comments"},"totalItems":{"type":["integer","null"],"description":"Total number of items, null if unknown","example":1309},"cursor":{"type":["string","null"],"description":"Current page cursor, null on first page","example":null},"nextCursor":{"type":["string","null"],"description":"Cursor for the next page, null on last page","example":"1772217402000"},"next":{"type":["string","null"],"format":"uri","description":"URL for the next page, null on last page","example":"https://api.konbiniapi.com/v1/tiktok/videos/7611615657754381599/comments?cursor=1772217402000&count=30"},"itemCount":{"type":"integer","description":"Number of items returned in this page","example":30},"orderedItems":{"type":"array","items":{"$ref":"#/components/schemas/TikTokComment"},"description":"Items in this page"}},"required":["@context","type","partOf","totalItems","cursor","nextCursor","next","itemCount","orderedItems"]}},"required":["data"]}}}},"400":{"description":"Bad Request — Invalid parameters","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["validation_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Validation error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"401":{"description":"Unauthorized — Missing or invalid API key","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["missing_api_key","invalid_api_key"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Invalid API key","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"402":{"description":"Payment Required — Credits exhausted","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["credits_exhausted"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Credits exhausted. Upgrade your plan at konbiniapi.com","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"403":{"description":"Forbidden — API key disabled or expired","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["api_key_disabled","api_key_expired"],"description":"Machine-readable error code"},"message":{"type":"string","example":"API key is disabled","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"404":{"description":"Not Found","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["not_found","route_not_found"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Not found","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"413":{"description":"Content Too Large — Request body exceeds 1 MB","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["validation_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Request body too large","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"500":{"description":"Internal Server Error","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["internal_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Internal error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"502":{"description":"Bad Gateway — Upstream platform error","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["platform_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Platform error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"503":{"description":"Service Unavailable","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["service_unavailable"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Service unavailable","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"504":{"description":"Gateway Timeout — Upstream platform timed out","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["platform_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Platform error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}}}}},"/v1/tiktok/videos/{videoId}/comments/{commentId}/replies":{"get":{"operationId":"tiktokGetCommentReplies","tags":["TikTok"],"summary":"Get comment replies","description":"Returns a paginated list of replies to a TikTok comment. Maximum 50 per page. Includes author info, like counts, and reply timestamps.","parameters":[{"schema":{"type":"string","description":"TikTok video ID","example":"7611615657754381599"},"required":true,"description":"TikTok video ID","name":"videoId","in":"path"},{"schema":{"type":"string","description":"TikTok comment ID","example":"7611616052479869736"},"required":true,"description":"TikTok comment ID","name":"commentId","in":"path"},{"schema":{"type":"integer","minimum":1,"maximum":50,"default":50,"description":"Number of replies to fetch (maximum: 50)","example":50},"required":false,"description":"Number of replies to fetch (maximum: 50)","name":"count","in":"query"},{"schema":{"type":"string","default":"0","description":"Pagination cursor","example":"0"},"required":false,"description":"Pagination cursor","name":"cursor","in":"query"}],"responses":{"200":{"description":"Returns the comment replies","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"@context":{"type":"array","prefixItems":[{"type":"string","enum":["https://www.w3.org/ns/activitystreams#"]},{"type":"string","enum":["https://konbiniapi.com/ns/social#"]}],"description":"ActivityStreams JSON-LD context","example":["https://www.w3.org/ns/activitystreams#","https://konbiniapi.com/ns/social#"]},"type":{"type":"string","description":"ActivityStreams collection type","example":"OrderedCollectionPage"},"partOf":{"type":"string","format":"uri","description":"URL of the full collection","example":"https://api.konbiniapi.com/v1/tiktok/videos/7611615657754381599/comments/7611646895321105170/replies"},"totalItems":{"type":["integer","null"],"description":"Total number of items, null if unknown","example":1309},"cursor":{"type":["string","null"],"description":"Current page cursor, null on first page","example":null},"nextCursor":{"type":["string","null"],"description":"Cursor for the next page, null on last page","example":"1772217402000"},"next":{"type":["string","null"],"format":"uri","description":"URL for the next page, null on last page","example":"https://api.konbiniapi.com/v1/tiktok/videos/7611615657754381599/comments/7611646895321105170/replies?cursor=1772217402000&count=30"},"itemCount":{"type":"integer","description":"Number of items returned in this page","example":30},"orderedItems":{"type":"array","items":{"$ref":"#/components/schemas/TikTokComment"},"description":"Items in this page"}},"required":["@context","type","partOf","totalItems","cursor","nextCursor","next","itemCount","orderedItems"]}},"required":["data"]}}}},"400":{"description":"Bad Request — Invalid parameters","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["validation_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Validation error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"401":{"description":"Unauthorized — Missing or invalid API key","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["missing_api_key","invalid_api_key"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Invalid API key","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"402":{"description":"Payment Required — Credits exhausted","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["credits_exhausted"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Credits exhausted. Upgrade your plan at konbiniapi.com","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"403":{"description":"Forbidden — API key disabled or expired","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["api_key_disabled","api_key_expired"],"description":"Machine-readable error code"},"message":{"type":"string","example":"API key is disabled","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"404":{"description":"Not Found","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["not_found","route_not_found"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Not found","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"413":{"description":"Content Too Large — Request body exceeds 1 MB","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["validation_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Request body too large","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"500":{"description":"Internal Server Error","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["internal_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Internal error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"502":{"description":"Bad Gateway — Upstream platform error","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["platform_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Platform error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"503":{"description":"Service Unavailable","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["service_unavailable"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Service unavailable","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"504":{"description":"Gateway Timeout — Upstream platform timed out","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["platform_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Platform error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}}}}},"/v1/tiktok/videos/{videoId}/transcripts/{language}":{"get":{"operationId":"tiktokGetVideoTranscript","tags":["TikTok"],"summary":"Get video transcript","description":"Returns the transcript for a video. Use `original` as the language to return the auto-generated transcript, or provide a BCP47 language code for machine-translated subtitles. Returns WebVTT format.","parameters":[{"schema":{"type":"string","description":"TikTok video ID","example":"7527278440291126550"},"required":true,"description":"TikTok video ID","name":"videoId","in":"path"},{"schema":{"type":"string","enum":["original","ar-SA","az-AZ","ca-ES","ceb-PH","cs-CZ","da-DK","de-DE","en-US","es-ES","et-EE","fi-FI","fil-PH","fr-FR","ga-IE","he-IL","hr-HR","id-ID","it-IT","ja-JP","ko-KR","lv-LV","lt-LT","ms-MY","nb-NO","nl-NL","pl-PL","pt-PT","ru-RU","sw-SW","sv-SE","th-TH","uk-UA","vi-VN","zh-Hans-CN","zh-Hant-CN"],"description":"BCP47 language code, or `original`","example":"en-US"},"required":true,"description":"BCP47 language code, or `original`","name":"language","in":"path"}],"responses":{"200":{"description":"Returns the transcript in Document format or raw WebVTT","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"@context":{"type":"array","prefixItems":[{"type":"string","enum":["https://www.w3.org/ns/activitystreams#"]},{"type":"string","enum":["https://konbiniapi.com/ns/social#"]}],"description":"ActivityStreams JSON-LD context","example":["https://www.w3.org/ns/activitystreams#","https://konbiniapi.com/ns/social#"]},"type":{"type":"string","description":"ActivityStreams object type","example":"Document"},"id":{"type":"string","format":"uri","description":"Transcript permalink","example":"https://www.tiktok.com/@khaby.lame/video/7611615657754381599/transcript/en-US"},"url":{"type":"string","format":"uri","description":"Video permalink","example":"https://www.tiktok.com/@khaby.lame/video/7611615657754381599"},"mediaType":{"type":"string","description":"MIME type","example":"text/vtt"},"language":{"type":"string","description":"BCP47 language code","example":"en-US"},"size":{"type":"integer","description":"File size in bytes","example":1024},"source":{"type":"string","description":"Source of the transcript: \"ASR\" (Automatic Speech Recognition) or \"MT\" (Machine Translation)","example":"ASR"},"content":{"type":"string","description":"WebVTT formatted transcript content","example":"WEBVTT\n\n00:00:00.000 --> 00:00:02.000\nHello everyone"}},"required":["@context","type","id","url","mediaType","language","content"]}},"required":["data"]}},"text/vtt":{"schema":{"type":"string"}}}},"400":{"description":"Bad Request — Invalid parameters","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["validation_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Validation error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"401":{"description":"Unauthorized — Missing or invalid API key","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["missing_api_key","invalid_api_key"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Invalid API key","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"402":{"description":"Payment Required — Credits exhausted","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["credits_exhausted"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Credits exhausted. Upgrade your plan at konbiniapi.com","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"403":{"description":"Forbidden — API key disabled or expired","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["api_key_disabled","api_key_expired"],"description":"Machine-readable error code"},"message":{"type":"string","example":"API key is disabled","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"404":{"description":"Not Found","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["not_found","route_not_found"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Not found","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"413":{"description":"Content Too Large — Request body exceeds 1 MB","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["validation_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Request body too large","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"500":{"description":"Internal Server Error","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["internal_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Internal error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"502":{"description":"Bad Gateway — Upstream platform error","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["platform_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Platform error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"503":{"description":"Service Unavailable","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["service_unavailable"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Service unavailable","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"504":{"description":"Gateway Timeout — Upstream platform timed out","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["platform_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Platform error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}}}}},"/v1/tiktok/tags/{tagName}":{"get":{"operationId":"tiktokGetTagVideos","tags":["TikTok"],"summary":"Get videos with tag","description":"Returns TikTok videos associated with a hashtag or challenge. The tag name is resolved to an internal ID automatically. Includes video details and engagement counts.","parameters":[{"schema":{"type":"string","description":"Tag name","example":"learnfromkhaby"},"required":true,"description":"Tag name","name":"tagName","in":"path"},{"schema":{"type":"integer","minimum":1,"maximum":30,"default":30,"description":"Number of videos to fetch (maximum: 30)","example":30},"required":false,"description":"Number of videos to fetch (maximum: 30)","name":"count","in":"query"},{"schema":{"type":"string","default":"0","description":"Pagination cursor","example":"0"},"required":false,"description":"Pagination cursor","name":"cursor","in":"query"}],"responses":{"200":{"description":"Returns the tag videos","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"@context":{"type":"array","prefixItems":[{"type":"string","enum":["https://www.w3.org/ns/activitystreams#"]},{"type":"string","enum":["https://konbiniapi.com/ns/social#"]}],"description":"ActivityStreams JSON-LD context","example":["https://www.w3.org/ns/activitystreams#","https://konbiniapi.com/ns/social#"]},"type":{"type":"string","description":"ActivityStreams collection type","example":"OrderedCollectionPage"},"partOf":{"type":"string","format":"uri","description":"URL of the full collection","example":"https://api.konbiniapi.com/v1/tiktok/tags/learnfromkhaby/videos"},"totalItems":{"type":["integer","null"],"description":"Total number of items, null if unknown","example":1309},"cursor":{"type":["string","null"],"description":"Current page cursor, null on first page","example":null},"nextCursor":{"type":["string","null"],"description":"Cursor for the next page, null on last page","example":"1772217402000"},"next":{"type":["string","null"],"format":"uri","description":"URL for the next page, null on last page","example":"https://api.konbiniapi.com/v1/tiktok/tags/learnfromkhaby/videos?cursor=1772217402000&count=30"},"itemCount":{"type":"integer","description":"Number of items returned in this page","example":30},"orderedItems":{"type":"array","items":{"$ref":"#/components/schemas/TikTokVideo"},"description":"Items in this page"}},"required":["@context","type","partOf","totalItems","cursor","nextCursor","next","itemCount","orderedItems"]}},"required":["data"]}}}},"400":{"description":"Bad Request — Invalid parameters","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["validation_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Validation error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"401":{"description":"Unauthorized — Missing or invalid API key","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["missing_api_key","invalid_api_key"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Invalid API key","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"402":{"description":"Payment Required — Credits exhausted","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["credits_exhausted"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Credits exhausted. Upgrade your plan at konbiniapi.com","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"403":{"description":"Forbidden — API key disabled or expired","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["api_key_disabled","api_key_expired"],"description":"Machine-readable error code"},"message":{"type":"string","example":"API key is disabled","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"404":{"description":"Not Found","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["not_found","route_not_found"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Not found","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"413":{"description":"Content Too Large — Request body exceeds 1 MB","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["validation_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Request body too large","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"500":{"description":"Internal Server Error","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["internal_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Internal error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"502":{"description":"Bad Gateway — Upstream platform error","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["platform_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Platform error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"503":{"description":"Service Unavailable","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["service_unavailable"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Service unavailable","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"504":{"description":"Gateway Timeout — Upstream platform timed out","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["platform_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Platform error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}}}}},"/v1/tiktok/collections/{collectionId}":{"get":{"operationId":"tiktokGetCollectionVideos","tags":["TikTok"],"summary":"Get collection videos","description":"Returns a paginated list of videos in a TikTok collection (playlist or mix). Maximum 35 per page. Includes full video details and engagement counts.","parameters":[{"schema":{"type":"string","description":"TikTok collection ID (mix ID)","example":"6966746276732559110"},"required":true,"description":"TikTok collection ID (mix ID)","name":"collectionId","in":"path"},{"schema":{"type":"integer","minimum":1,"maximum":35,"default":20,"description":"Number of videos to fetch (maximum: 35)","example":20},"required":false,"description":"Number of videos to fetch (maximum: 35)","name":"count","in":"query"},{"schema":{"type":"string","default":"0","description":"Pagination cursor","example":"0"},"required":false,"description":"Pagination cursor","name":"cursor","in":"query"}],"responses":{"200":{"description":"Returns the collection videos","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"@context":{"type":"array","prefixItems":[{"type":"string","enum":["https://www.w3.org/ns/activitystreams#"]},{"type":"string","enum":["https://konbiniapi.com/ns/social#"]}],"description":"ActivityStreams JSON-LD context","example":["https://www.w3.org/ns/activitystreams#","https://konbiniapi.com/ns/social#"]},"type":{"type":"string","description":"ActivityStreams collection type","example":"OrderedCollectionPage"},"partOf":{"type":"string","format":"uri","description":"URL of the full collection","example":"https://api.konbiniapi.com/v1/tiktok/collections/7200000000000000001/videos"},"totalItems":{"type":["integer","null"],"description":"Total number of items, null if unknown","example":1309},"cursor":{"type":["string","null"],"description":"Current page cursor, null on first page","example":null},"nextCursor":{"type":["string","null"],"description":"Cursor for the next page, null on last page","example":"1772217402000"},"next":{"type":["string","null"],"format":"uri","description":"URL for the next page, null on last page","example":"https://api.konbiniapi.com/v1/tiktok/collections/7200000000000000001/videos?cursor=1772217402000&count=30"},"itemCount":{"type":"integer","description":"Number of items returned in this page","example":30},"orderedItems":{"type":"array","items":{"$ref":"#/components/schemas/TikTokVideo"},"description":"Items in this page"}},"required":["@context","type","partOf","totalItems","cursor","nextCursor","next","itemCount","orderedItems"]}},"required":["data"]}}}},"400":{"description":"Bad Request — Invalid parameters","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["validation_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Validation error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"401":{"description":"Unauthorized — Missing or invalid API key","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["missing_api_key","invalid_api_key"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Invalid API key","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"402":{"description":"Payment Required — Credits exhausted","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["credits_exhausted"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Credits exhausted. Upgrade your plan at konbiniapi.com","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"403":{"description":"Forbidden — API key disabled or expired","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["api_key_disabled","api_key_expired"],"description":"Machine-readable error code"},"message":{"type":"string","example":"API key is disabled","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"404":{"description":"Not Found","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["not_found","route_not_found"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Not found","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"413":{"description":"Content Too Large — Request body exceeds 1 MB","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["validation_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Request body too large","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"500":{"description":"Internal Server Error","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["internal_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Internal error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"502":{"description":"Bad Gateway — Upstream platform error","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["platform_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Platform error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"503":{"description":"Service Unavailable","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["service_unavailable"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Service unavailable","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"504":{"description":"Gateway Timeout — Upstream platform timed out","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["platform_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Platform error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}}}}},"/v1/tiktok/audios/{audioId}":{"get":{"operationId":"tiktokGetAudio","tags":["TikTok"],"summary":"Get audio details","description":"Returns metadata for a TikTok audio track including title, artist, duration, usage count, and cover image. Look up any sound by its audio ID.","parameters":[{"schema":{"type":"string","description":"TikTok audio/music ID","example":"6931290927570946049"},"required":true,"description":"TikTok audio/music ID","name":"audioId","in":"path"}],"responses":{"200":{"description":"Returns the audio details","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"@context":{"type":"array","prefixItems":[{"type":"string","enum":["https://www.w3.org/ns/activitystreams#"]},{"type":"string","enum":["https://konbiniapi.com/ns/social#"]}],"description":"ActivityStreams JSON-LD context","example":["https://www.w3.org/ns/activitystreams#","https://konbiniapi.com/ns/social#"]},"type":{"type":"string","description":"ActivityStreams object type","example":"Audio"},"id":{"type":"string","format":"uri","description":"Audio permalink","example":"https://www.tiktok.com/music/original-sound-7611615657754381599"},"url":{"type":"string","format":"uri","description":"Audio playback URL","example":"https://sf16-ies-music.tiktokcdn.com/obj/tos-alisg-v/123456"},"name":{"type":"string","description":"Track name","example":"original sound"},"duration":{"type":"number","description":"Duration in seconds","example":23},"mediaType":{"type":"string","description":"MIME type","example":"audio/mpeg"},"attributedTo":{"anyOf":[{"$ref":"#/components/schemas/TikTokEmbeddedUser"},{"type":"array","items":{"$ref":"#/components/schemas/TikTokEmbeddedUser"}}],"description":"Audio creator or artist"},"icon":{"allOf":[{"$ref":"#/components/schemas/TikTokImage"},{"description":"Thumbnail image"}]},"image":{"type":"array","items":{"$ref":"#/components/schemas/TikTokImage"},"description":"Cover images in multiple sizes"},"entityId":{"type":"string","description":"Audio ID","example":"7493556331997071377"},"album":{"type":"string","description":"Album name","example":"Greatest Hits"},"isOriginal":{"type":"boolean","description":"Whether audio is user-created vs a licensed track","example":false},"isCopyrighted":{"type":"boolean","description":"Whether audio has copyright restrictions","example":false},"videoCount":{"type":"integer","description":"Number of videos using this audio","example":500000}},"required":["@context","type","name","duration"]}},"required":["data"]}}}},"400":{"description":"Bad Request — Invalid parameters","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["validation_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Validation error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"401":{"description":"Unauthorized — Missing or invalid API key","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["missing_api_key","invalid_api_key"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Invalid API key","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"402":{"description":"Payment Required — Credits exhausted","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["credits_exhausted"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Credits exhausted. Upgrade your plan at konbiniapi.com","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"403":{"description":"Forbidden — API key disabled or expired","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["api_key_disabled","api_key_expired"],"description":"Machine-readable error code"},"message":{"type":"string","example":"API key is disabled","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"404":{"description":"Not Found","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["not_found","route_not_found"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Not found","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"413":{"description":"Content Too Large — Request body exceeds 1 MB","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["validation_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Request body too large","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"500":{"description":"Internal Server Error","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["internal_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Internal error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"502":{"description":"Bad Gateway — Upstream platform error","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["platform_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Platform error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"503":{"description":"Service Unavailable","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["service_unavailable"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Service unavailable","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"504":{"description":"Gateway Timeout — Upstream platform timed out","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["platform_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Platform error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}}}}},"/v1/tiktok/audios/{audioId}/videos":{"get":{"operationId":"tiktokGetAudioVideos","tags":["TikTok"],"summary":"Get videos with audio","description":"Returns a paginated list of TikTok videos using a specific audio track. Maximum 30 per page. Discover trending content by sound or music.","parameters":[{"schema":{"type":"string","description":"TikTok audio/music ID","example":"6931290927570946049"},"required":true,"description":"TikTok audio/music ID","name":"audioId","in":"path"},{"schema":{"type":"integer","minimum":1,"maximum":30,"default":30,"description":"Number of videos to fetch (maximum: 30)","example":30},"required":false,"description":"Number of videos to fetch (maximum: 30)","name":"count","in":"query"},{"schema":{"type":"string","default":"0","description":"Pagination cursor","example":"0"},"required":false,"description":"Pagination cursor","name":"cursor","in":"query"}],"responses":{"200":{"description":"Returns the audio videos","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"@context":{"type":"array","prefixItems":[{"type":"string","enum":["https://www.w3.org/ns/activitystreams#"]},{"type":"string","enum":["https://konbiniapi.com/ns/social#"]}],"description":"ActivityStreams JSON-LD context","example":["https://www.w3.org/ns/activitystreams#","https://konbiniapi.com/ns/social#"]},"type":{"type":"string","description":"ActivityStreams collection type","example":"OrderedCollectionPage"},"partOf":{"type":"string","format":"uri","description":"URL of the full collection","example":"https://api.konbiniapi.com/v1/tiktok/audios/7611615657754381599/videos"},"totalItems":{"type":["integer","null"],"description":"Total number of items, null if unknown","example":1309},"cursor":{"type":["string","null"],"description":"Current page cursor, null on first page","example":null},"nextCursor":{"type":["string","null"],"description":"Cursor for the next page, null on last page","example":"1772217402000"},"next":{"type":["string","null"],"format":"uri","description":"URL for the next page, null on last page","example":"https://api.konbiniapi.com/v1/tiktok/audios/7611615657754381599/videos?cursor=1772217402000&count=30"},"itemCount":{"type":"integer","description":"Number of items returned in this page","example":30},"orderedItems":{"type":"array","items":{"$ref":"#/components/schemas/TikTokVideo"},"description":"Items in this page"}},"required":["@context","type","partOf","totalItems","cursor","nextCursor","next","itemCount","orderedItems"]}},"required":["data"]}}}},"400":{"description":"Bad Request — Invalid parameters","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["validation_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Validation error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"401":{"description":"Unauthorized — Missing or invalid API key","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["missing_api_key","invalid_api_key"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Invalid API key","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"402":{"description":"Payment Required — Credits exhausted","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["credits_exhausted"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Credits exhausted. Upgrade your plan at konbiniapi.com","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"403":{"description":"Forbidden — API key disabled or expired","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["api_key_disabled","api_key_expired"],"description":"Machine-readable error code"},"message":{"type":"string","example":"API key is disabled","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"404":{"description":"Not Found","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["not_found","route_not_found"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Not found","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"413":{"description":"Content Too Large — Request body exceeds 1 MB","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["validation_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Request body too large","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"500":{"description":"Internal Server Error","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["internal_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Internal error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"502":{"description":"Bad Gateway — Upstream platform error","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["platform_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Platform error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"503":{"description":"Service Unavailable","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["service_unavailable"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Service unavailable","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"504":{"description":"Gateway Timeout — Upstream platform timed out","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["platform_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Platform error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}}}}},"/v1/tiktok/search":{"get":{"operationId":"tiktokSearchContent","tags":["TikTok"],"summary":"Search content","description":"General search that returns mixed results including videos and user profiles. Supports sorting and publish-time filters.","parameters":[{"schema":{"type":"string","minLength":1,"description":"Search query","example":"khaby.lame"},"required":true,"description":"Search query","name":"query","in":"query"},{"schema":{"type":"string","default":"0","description":"Pagination cursor","example":"0"},"required":false,"description":"Pagination cursor","name":"cursor","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":50,"description":"Number of items to fetch (maximum: 100, actual results may vary)","example":50},"required":false,"description":"Number of items to fetch (maximum: 100, actual results may vary)","name":"count","in":"query"},{"schema":{"type":"string","enum":["relevance","most-liked","date-posted"],"default":"relevance","description":"Sort order: relevance (default), most-liked, or date-posted","example":"relevance"},"required":false,"description":"Sort order: relevance (default), most-liked, or date-posted","name":"order","in":"query"},{"schema":{"type":"string","enum":["all-time","yesterday","this-week","this-month","last-3-months","last-6-months"],"default":"all-time","description":"Filter by publish time: all-time (default), yesterday, this-week, this-month, last-3-months, or last-6-months","example":"all-time"},"required":false,"description":"Filter by publish time: all-time (default), yesterday, this-week, this-month, last-3-months, or last-6-months","name":"published","in":"query"}],"responses":{"200":{"description":"Returns the search results","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"@context":{"type":"array","prefixItems":[{"type":"string","enum":["https://www.w3.org/ns/activitystreams#"]},{"type":"string","enum":["https://konbiniapi.com/ns/social#"]}],"description":"ActivityStreams JSON-LD context","example":["https://www.w3.org/ns/activitystreams#","https://konbiniapi.com/ns/social#"]},"type":{"type":"string","description":"ActivityStreams collection type","example":"OrderedCollectionPage"},"partOf":{"type":"string","format":"uri","description":"URL of the full collection","example":"https://api.konbiniapi.com/v1/tiktok/search"},"totalItems":{"type":["integer","null"],"description":"Total number of items, null if unknown","example":1309},"cursor":{"type":["string","null"],"description":"Current page cursor, null on first page","example":null},"nextCursor":{"type":["string","null"],"description":"Cursor for the next page, null on last page","example":"1772217402000"},"next":{"type":["string","null"],"format":"uri","description":"URL for the next page, null on last page","example":"https://api.konbiniapi.com/v1/tiktok/search?query=khaby&cursor=1772217402000&count=30"},"itemCount":{"type":"integer","description":"Number of items returned in this page","example":30},"orderedItems":{"type":"array","items":{"oneOf":[{"allOf":[{"$ref":"#/components/schemas/TikTokVideo"},{"type":"object","properties":{"type":{"type":"string","enum":["Video"]}}}],"description":"Video post"},{"allOf":[{"$ref":"#/components/schemas/TikTokEmbeddedUser"},{"type":"object","properties":{"type":{"type":"string","enum":["Person"]}}}],"description":"Compact user profile for embedded contexts"},{"allOf":[{"$ref":"#/components/schemas/TikTokEmbeddedUser"},{"type":"object","properties":{"type":{"type":"string","enum":["Organization"]}}}],"description":"Compact user profile for embedded contexts"}]},"description":"Items in this page"}},"required":["@context","type","partOf","totalItems","cursor","nextCursor","next","itemCount","orderedItems"]}},"required":["data"]}}}},"400":{"description":"Bad Request — Invalid parameters","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["validation_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Validation error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"401":{"description":"Unauthorized — Missing or invalid API key","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["missing_api_key","invalid_api_key"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Invalid API key","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"402":{"description":"Payment Required — Credits exhausted","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["credits_exhausted"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Credits exhausted. Upgrade your plan at konbiniapi.com","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"403":{"description":"Forbidden — API key disabled or expired","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["api_key_disabled","api_key_expired"],"description":"Machine-readable error code"},"message":{"type":"string","example":"API key is disabled","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"404":{"description":"Not Found","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["not_found","route_not_found"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Not found","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"413":{"description":"Content Too Large — Request body exceeds 1 MB","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["validation_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Request body too large","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"500":{"description":"Internal Server Error","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["internal_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Internal error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"502":{"description":"Bad Gateway — Upstream platform error","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["platform_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Platform error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"503":{"description":"Service Unavailable","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["service_unavailable"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Service unavailable","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"504":{"description":"Gateway Timeout — Upstream platform timed out","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["platform_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Platform error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}}}}},"/v1/tiktok/search/users":{"get":{"operationId":"tiktokSearchUsers","tags":["TikTok"],"summary":"Search users","description":"Searches TikTok for user profiles matching a query. Fixed page size of 10 (platform limit). Returns profile details including follower counts and verification status.","parameters":[{"schema":{"type":"string","minLength":1,"description":"Search query","example":"khaby.lame"},"required":true,"description":"Search query","name":"query","in":"query"},{"schema":{"type":"integer","minimum":10,"maximum":10,"default":10,"description":"Page size (fixed at 10 by the platform)","example":10},"required":false,"description":"Page size (fixed at 10 by the platform)","name":"count","in":"query"},{"schema":{"type":"string","default":"0","description":"Pagination cursor","example":"0"},"required":false,"description":"Pagination cursor","name":"cursor","in":"query"}],"responses":{"200":{"description":"Returns the search results","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"@context":{"type":"array","prefixItems":[{"type":"string","enum":["https://www.w3.org/ns/activitystreams#"]},{"type":"string","enum":["https://konbiniapi.com/ns/social#"]}],"description":"ActivityStreams JSON-LD context","example":["https://www.w3.org/ns/activitystreams#","https://konbiniapi.com/ns/social#"]},"type":{"type":"string","description":"ActivityStreams collection type","example":"OrderedCollectionPage"},"partOf":{"type":"string","format":"uri","description":"URL of the full collection","example":"https://api.konbiniapi.com/v1/tiktok/search/users"},"totalItems":{"type":["integer","null"],"description":"Total number of items, null if unknown","example":1309},"cursor":{"type":["string","null"],"description":"Current page cursor, null on first page","example":null},"nextCursor":{"type":["string","null"],"description":"Cursor for the next page, null on last page","example":"1772217402000"},"next":{"type":["string","null"],"format":"uri","description":"URL for the next page, null on last page","example":"https://api.konbiniapi.com/v1/tiktok/search/users?query=khaby&cursor=1772217402000&count=30"},"itemCount":{"type":"integer","description":"Number of items returned in this page","example":30},"orderedItems":{"type":"array","items":{"$ref":"#/components/schemas/TikTokEmbeddedUser"},"description":"Items in this page"}},"required":["@context","type","partOf","totalItems","cursor","nextCursor","next","itemCount","orderedItems"]}},"required":["data"]}}}},"400":{"description":"Bad Request — Invalid parameters","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["validation_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Validation error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"401":{"description":"Unauthorized — Missing or invalid API key","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["missing_api_key","invalid_api_key"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Invalid API key","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"402":{"description":"Payment Required — Credits exhausted","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["credits_exhausted"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Credits exhausted. Upgrade your plan at konbiniapi.com","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"403":{"description":"Forbidden — API key disabled or expired","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["api_key_disabled","api_key_expired"],"description":"Machine-readable error code"},"message":{"type":"string","example":"API key is disabled","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"404":{"description":"Not Found","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["not_found","route_not_found"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Not found","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"413":{"description":"Content Too Large — Request body exceeds 1 MB","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["validation_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Request body too large","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"500":{"description":"Internal Server Error","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["internal_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Internal error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"502":{"description":"Bad Gateway — Upstream platform error","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["platform_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Platform error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"503":{"description":"Service Unavailable","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["service_unavailable"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Service unavailable","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"504":{"description":"Gateway Timeout — Upstream platform timed out","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["platform_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Platform error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}}}}},"/v1/tiktok/search/videos":{"get":{"operationId":"tiktokSearchVideos","tags":["TikTok"],"summary":"Search videos","description":"Searches TikTok for videos matching a query. Supports filtering by publish time and sorting by relevance, likes, or date.","parameters":[{"schema":{"type":"string","minLength":1,"description":"Search query","example":"khaby.lame"},"required":true,"description":"Search query","name":"query","in":"query"},{"schema":{"type":"string","default":"0","description":"Pagination cursor","example":"0"},"required":false,"description":"Pagination cursor","name":"cursor","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":50,"description":"Number of videos to fetch (maximum: 100, actual results may vary)","example":50},"required":false,"description":"Number of videos to fetch (maximum: 100, actual results may vary)","name":"count","in":"query"},{"schema":{"type":"string","enum":["relevance","most-liked","date-posted"],"default":"relevance","description":"Sort order: relevance (default), most-liked, or date-posted","example":"relevance"},"required":false,"description":"Sort order: relevance (default), most-liked, or date-posted","name":"order","in":"query"},{"schema":{"type":"string","enum":["all-time","yesterday","this-week","this-month","last-3-months","last-6-months"],"default":"all-time","description":"Filter by publish time: all-time (default), yesterday, this-week, this-month, last-3-months, or last-6-months"},"required":false,"description":"Filter by publish time: all-time (default), yesterday, this-week, this-month, last-3-months, or last-6-months","name":"published","in":"query"}],"responses":{"200":{"description":"Returns the search results","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"@context":{"type":"array","prefixItems":[{"type":"string","enum":["https://www.w3.org/ns/activitystreams#"]},{"type":"string","enum":["https://konbiniapi.com/ns/social#"]}],"description":"ActivityStreams JSON-LD context","example":["https://www.w3.org/ns/activitystreams#","https://konbiniapi.com/ns/social#"]},"type":{"type":"string","description":"ActivityStreams collection type","example":"OrderedCollectionPage"},"partOf":{"type":"string","format":"uri","description":"URL of the full collection","example":"https://api.konbiniapi.com/v1/tiktok/search/videos"},"totalItems":{"type":["integer","null"],"description":"Total number of items, null if unknown","example":1309},"cursor":{"type":["string","null"],"description":"Current page cursor, null on first page","example":null},"nextCursor":{"type":["string","null"],"description":"Cursor for the next page, null on last page","example":"1772217402000"},"next":{"type":["string","null"],"format":"uri","description":"URL for the next page, null on last page","example":"https://api.konbiniapi.com/v1/tiktok/search/videos?query=khaby&cursor=1772217402000&count=30"},"itemCount":{"type":"integer","description":"Number of items returned in this page","example":30},"orderedItems":{"type":"array","items":{"$ref":"#/components/schemas/TikTokVideo"},"description":"Items in this page"}},"required":["@context","type","partOf","totalItems","cursor","nextCursor","next","itemCount","orderedItems"]}},"required":["data"]}}}},"400":{"description":"Bad Request — Invalid parameters","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["validation_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Validation error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"401":{"description":"Unauthorized — Missing or invalid API key","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["missing_api_key","invalid_api_key"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Invalid API key","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"402":{"description":"Payment Required — Credits exhausted","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["credits_exhausted"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Credits exhausted. Upgrade your plan at konbiniapi.com","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"403":{"description":"Forbidden — API key disabled or expired","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["api_key_disabled","api_key_expired"],"description":"Machine-readable error code"},"message":{"type":"string","example":"API key is disabled","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"404":{"description":"Not Found","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["not_found","route_not_found"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Not found","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"413":{"description":"Content Too Large — Request body exceeds 1 MB","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["validation_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Request body too large","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"500":{"description":"Internal Server Error","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["internal_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Internal error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"502":{"description":"Bad Gateway — Upstream platform error","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["platform_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Platform error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"503":{"description":"Service Unavailable","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["service_unavailable"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Service unavailable","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"504":{"description":"Gateway Timeout — Upstream platform timed out","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["platform_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Platform error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}}}}},"/v1/instagram/users/{username}":{"get":{"operationId":"instagramGetUser","tags":["Instagram"],"summary":"Get user profile","description":"Returns profile information for an Instagram user including bio, follower counts, profile picture, and account metadata. Look up any public Instagram account by username.","parameters":[{"schema":{"type":"string","description":"Instagram username (with or without @ symbol)","example":"khaby00"},"required":true,"description":"Instagram username (with or without @ symbol)","name":"username","in":"path"}],"responses":{"200":{"description":"Returns the Instagram user profile","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"@context":{"type":"array","prefixItems":[{"type":"string","enum":["https://www.w3.org/ns/activitystreams#"]},{"type":"string","enum":["https://konbiniapi.com/ns/social#"]}],"description":"ActivityStreams JSON-LD context","example":["https://www.w3.org/ns/activitystreams#","https://konbiniapi.com/ns/social#"]},"type":{"type":"string","description":"ActivityStreams object type","example":"Person"},"id":{"type":"string","format":"uri","description":"Profile URL","example":"https://www.instagram.com/khaby00/"},"url":{"type":"string","format":"uri","description":"Profile URL","example":"https://www.instagram.com/khaby00/"},"entityId":{"type":"string","description":"Platform-specific entity ID","example":"779085683"},"name":{"type":"string","description":"Display name","example":"Khabane Lame"},"preferredUsername":{"type":"string","description":"Username or handle","example":"khaby00"},"summary":{"type":"string","description":"Bio text","example":"Just a guy who reacts"},"attachment":{"type":"array","items":{"$ref":"#/components/schemas/InstagramLink"},"description":"External links"},"isPrivate":{"type":"boolean","description":"Whether account is private","example":false},"isVerified":{"type":"boolean","description":"Whether account is verified","example":true},"isPaidVerified":{"type":"boolean","description":"Whether account has paid verification","example":false},"isBusiness":{"type":"boolean","description":"Whether account has business features enabled","example":false},"isProfessional":{"type":"boolean","description":"Whether account has professional/creator features enabled","example":true},"category":{"type":"string","description":"Business or creator category","example":"Public figure"},"pronouns":{"type":"array","items":{"type":"string"},"description":"User pronouns","example":["he/him"]},"hasVideos":{"type":"boolean","description":"Whether user has video content","example":true},"hasChannel":{"type":"boolean","description":"Whether user has a broadcast channel","example":false},"hasMicroblog":{"type":"boolean","description":"Whether user has Threads content","example":true},"followerCount":{"type":"integer","description":"Number of followers","example":77560380},"followingCount":{"type":"integer","description":"Number of accounts followed","example":1004},"mediaCount":{"type":"integer","description":"Number of posts","example":626},"videoCount":{"type":"integer","description":"Number of Reels","example":120},"highlightCount":{"type":"integer","description":"Number of story highlights","example":10},"icon":{"$ref":"#/components/schemas/InstagramImage","description":"User profile picture"},"image":{"type":"array","items":{"$ref":"#/components/schemas/InstagramImage"},"description":"Profile pictures in multiple sizes"}},"required":["@context","type","id","url","entityId","name","preferredUsername","isPrivate","isVerified","isPaidVerified","isBusiness","isProfessional","hasVideos","hasChannel","hasMicroblog","followerCount","followingCount","mediaCount","videoCount","highlightCount"]}},"required":["data"]}}}},"400":{"description":"Bad Request — Invalid parameters","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["validation_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Validation error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"401":{"description":"Unauthorized — Missing or invalid API key","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["missing_api_key","invalid_api_key"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Invalid API key","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"402":{"description":"Payment Required — Credits exhausted","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["credits_exhausted"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Credits exhausted. Upgrade your plan at konbiniapi.com","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"403":{"description":"Forbidden — API key disabled or expired","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["api_key_disabled","api_key_expired"],"description":"Machine-readable error code"},"message":{"type":"string","example":"API key is disabled","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"404":{"description":"Not Found","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["not_found","route_not_found"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Not found","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"413":{"description":"Content Too Large — Request body exceeds 1 MB","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["validation_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Request body too large","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"500":{"description":"Internal Server Error","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["internal_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Internal error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"502":{"description":"Bad Gateway — Upstream platform error","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["platform_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Platform error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"503":{"description":"Service Unavailable","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["service_unavailable"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Service unavailable","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"504":{"description":"Gateway Timeout — Upstream platform timed out","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["platform_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Platform error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}}}}},"/v1/instagram/users/{username}/posts":{"get":{"operationId":"instagramGetUserPosts","tags":["Instagram"],"summary":"Get user posts","description":"Returns a paginated list of posts from an Instagram user's profile feed. Maximum 12 posts per page. Includes photos, videos, carousels, and engagement counts.","parameters":[{"schema":{"type":"string","description":"Instagram username (with or without @ symbol)","example":"khaby00"},"required":true,"description":"Instagram username (with or without @ symbol)","name":"username","in":"path"},{"schema":{"type":"integer","minimum":1,"maximum":12,"default":12,"description":"Number of posts to fetch (maximum: 12)","example":12},"required":false,"description":"Number of posts to fetch (maximum: 12)","name":"count","in":"query"},{"schema":{"type":"string","description":"Pagination cursor","example":"0"},"required":false,"description":"Pagination cursor","name":"cursor","in":"query"}],"responses":{"200":{"description":"Returns the user posts","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"@context":{"type":"array","prefixItems":[{"type":"string","enum":["https://www.w3.org/ns/activitystreams#"]},{"type":"string","enum":["https://konbiniapi.com/ns/social#"]}],"description":"ActivityStreams JSON-LD context","example":["https://www.w3.org/ns/activitystreams#","https://konbiniapi.com/ns/social#"]},"type":{"type":"string","description":"ActivityStreams collection type","example":"OrderedCollectionPage"},"partOf":{"type":"string","format":"uri","description":"URL of the full collection","example":"https://api.konbiniapi.com/v1/instagram/users/khaby00/posts"},"totalItems":{"type":["integer","null"],"description":"Total number of items, null if unknown","example":1309},"cursor":{"type":["string","null"],"description":"Current page cursor, null on first page","example":null},"nextCursor":{"type":["string","null"],"description":"Cursor for the next page, null on last page","example":"abc123"},"next":{"type":["string","null"],"format":"uri","description":"URL for the next page, null on last page","example":"https://api.konbiniapi.com/v1/instagram/users/khaby00/posts?cursor=abc123&count=12"},"itemCount":{"type":"integer","description":"Number of items returned in this page","example":30},"orderedItems":{"type":"array","items":{"$ref":"#/components/schemas/InstagramPost"},"description":"Items in this page"}},"required":["@context","type","partOf","totalItems","cursor","nextCursor","next","itemCount","orderedItems"]}},"required":["data"]}}}},"400":{"description":"Bad Request — Invalid parameters","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["validation_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Validation error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"401":{"description":"Unauthorized — Missing or invalid API key","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["missing_api_key","invalid_api_key"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Invalid API key","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"402":{"description":"Payment Required — Credits exhausted","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["credits_exhausted"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Credits exhausted. Upgrade your plan at konbiniapi.com","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"403":{"description":"Forbidden — API key disabled or expired","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["api_key_disabled","api_key_expired"],"description":"Machine-readable error code"},"message":{"type":"string","example":"API key is disabled","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"404":{"description":"Not Found","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["not_found","route_not_found"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Not found","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"413":{"description":"Content Too Large — Request body exceeds 1 MB","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["validation_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Request body too large","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"500":{"description":"Internal Server Error","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["internal_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Internal error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"502":{"description":"Bad Gateway — Upstream platform error","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["platform_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Platform error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"503":{"description":"Service Unavailable","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["service_unavailable"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Service unavailable","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"504":{"description":"Gateway Timeout — Upstream platform timed out","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["platform_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Platform error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}}}}},"/v1/instagram/users/{username}/reels":{"get":{"operationId":"instagramGetUserReels","tags":["Instagram"],"summary":"Get user reels","description":"Returns a paginated list of reels from an Instagram user's profile. Maximum 12 reels per page. Includes video URLs, captions, and engagement counts.","parameters":[{"schema":{"type":"string","description":"Instagram username (with or without @ symbol)","example":"khaby00"},"required":true,"description":"Instagram username (with or without @ symbol)","name":"username","in":"path"},{"schema":{"type":"integer","minimum":1,"maximum":12,"default":12,"description":"Number of reels to fetch (maximum: 12)","example":12},"required":false,"description":"Number of reels to fetch (maximum: 12)","name":"count","in":"query"},{"schema":{"type":"string","description":"Pagination cursor","example":"0"},"required":false,"description":"Pagination cursor","name":"cursor","in":"query"}],"responses":{"200":{"description":"Returns the user reels","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"@context":{"type":"array","prefixItems":[{"type":"string","enum":["https://www.w3.org/ns/activitystreams#"]},{"type":"string","enum":["https://konbiniapi.com/ns/social#"]}],"description":"ActivityStreams JSON-LD context","example":["https://www.w3.org/ns/activitystreams#","https://konbiniapi.com/ns/social#"]},"type":{"type":"string","description":"ActivityStreams collection type","example":"OrderedCollectionPage"},"partOf":{"type":"string","format":"uri","description":"URL of the full collection","example":"https://api.konbiniapi.com/v1/instagram/users/khaby00/reels"},"totalItems":{"type":["integer","null"],"description":"Total number of items, null if unknown","example":1309},"cursor":{"type":["string","null"],"description":"Current page cursor, null on first page","example":null},"nextCursor":{"type":["string","null"],"description":"Cursor for the next page, null on last page","example":"abc123"},"next":{"type":["string","null"],"format":"uri","description":"URL for the next page, null on last page","example":"https://api.konbiniapi.com/v1/instagram/users/khaby00/reels?cursor=abc123&count=12"},"itemCount":{"type":"integer","description":"Number of items returned in this page","example":30},"orderedItems":{"type":"array","items":{"$ref":"#/components/schemas/InstagramPost"},"description":"Items in this page"}},"required":["@context","type","partOf","totalItems","cursor","nextCursor","next","itemCount","orderedItems"]}},"required":["data"]}}}},"400":{"description":"Bad Request — Invalid parameters","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["validation_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Validation error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"401":{"description":"Unauthorized — Missing or invalid API key","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["missing_api_key","invalid_api_key"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Invalid API key","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"402":{"description":"Payment Required — Credits exhausted","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["credits_exhausted"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Credits exhausted. Upgrade your plan at konbiniapi.com","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"403":{"description":"Forbidden — API key disabled or expired","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["api_key_disabled","api_key_expired"],"description":"Machine-readable error code"},"message":{"type":"string","example":"API key is disabled","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"404":{"description":"Not Found","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["not_found","route_not_found"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Not found","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"413":{"description":"Content Too Large — Request body exceeds 1 MB","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["validation_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Request body too large","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"500":{"description":"Internal Server Error","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["internal_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Internal error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"502":{"description":"Bad Gateway — Upstream platform error","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["platform_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Platform error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"503":{"description":"Service Unavailable","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["service_unavailable"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Service unavailable","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"504":{"description":"Gateway Timeout — Upstream platform timed out","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["platform_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Platform error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}}}}},"/v1/instagram/users/{username}/tagged":{"get":{"operationId":"instagramGetUserTagged","tags":["Instagram"],"summary":"Get user tagged posts","description":"Returns Instagram posts where the user has been tagged by other accounts. Maximum 12 posts per page. Includes full post details and engagement counts.","parameters":[{"schema":{"type":"string","description":"Instagram username (with or without @ symbol)","example":"khaby00"},"required":true,"description":"Instagram username (with or without @ symbol)","name":"username","in":"path"},{"schema":{"type":"integer","minimum":1,"maximum":12,"default":12,"description":"Number of posts to fetch (maximum: 12)","example":12},"required":false,"description":"Number of posts to fetch (maximum: 12)","name":"count","in":"query"},{"schema":{"type":"string","description":"Pagination cursor","example":"0"},"required":false,"description":"Pagination cursor","name":"cursor","in":"query"}],"responses":{"200":{"description":"Returns posts the user is tagged in","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"@context":{"type":"array","prefixItems":[{"type":"string","enum":["https://www.w3.org/ns/activitystreams#"]},{"type":"string","enum":["https://konbiniapi.com/ns/social#"]}],"description":"ActivityStreams JSON-LD context","example":["https://www.w3.org/ns/activitystreams#","https://konbiniapi.com/ns/social#"]},"type":{"type":"string","description":"ActivityStreams collection type","example":"OrderedCollectionPage"},"partOf":{"type":"string","format":"uri","description":"URL of the full collection","example":"https://api.konbiniapi.com/v1/instagram/users/khaby00/tagged"},"totalItems":{"type":["integer","null"],"description":"Total number of items, null if unknown","example":1309},"cursor":{"type":["string","null"],"description":"Current page cursor, null on first page","example":null},"nextCursor":{"type":["string","null"],"description":"Cursor for the next page, null on last page","example":"abc123"},"next":{"type":["string","null"],"format":"uri","description":"URL for the next page, null on last page","example":"https://api.konbiniapi.com/v1/instagram/users/khaby00/tagged?cursor=abc123&count=12"},"itemCount":{"type":"integer","description":"Number of items returned in this page","example":30},"orderedItems":{"type":"array","items":{"$ref":"#/components/schemas/InstagramPost"},"description":"Items in this page"}},"required":["@context","type","partOf","totalItems","cursor","nextCursor","next","itemCount","orderedItems"]}},"required":["data"]}}}},"400":{"description":"Bad Request — Invalid parameters","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["validation_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Validation error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"401":{"description":"Unauthorized — Missing or invalid API key","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["missing_api_key","invalid_api_key"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Invalid API key","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"402":{"description":"Payment Required — Credits exhausted","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["credits_exhausted"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Credits exhausted. Upgrade your plan at konbiniapi.com","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"403":{"description":"Forbidden — API key disabled or expired","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["api_key_disabled","api_key_expired"],"description":"Machine-readable error code"},"message":{"type":"string","example":"API key is disabled","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"404":{"description":"Not Found","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["not_found","route_not_found"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Not found","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"413":{"description":"Content Too Large — Request body exceeds 1 MB","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["validation_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Request body too large","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"500":{"description":"Internal Server Error","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["internal_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Internal error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"502":{"description":"Bad Gateway — Upstream platform error","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["platform_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Platform error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"503":{"description":"Service Unavailable","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["service_unavailable"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Service unavailable","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"504":{"description":"Gateway Timeout — Upstream platform timed out","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["platform_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Platform error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}}}}},"/v1/instagram/users/{username}/highlights":{"get":{"operationId":"instagramGetUserHighlights","tags":["Instagram"],"summary":"Get user story highlights","description":"Returns the list of story highlight reels on a user's profile. Use the highlight endpoint to get individual stories within a highlight.","parameters":[{"schema":{"type":"string","description":"Instagram username (with or without @ symbol)","example":"khaby00"},"required":true,"description":"Instagram username (with or without @ symbol)","name":"username","in":"path"},{"schema":{"type":"string","description":"Pagination cursor","example":"0"},"required":false,"description":"Pagination cursor","name":"cursor","in":"query"}],"responses":{"200":{"description":"Returns the user story highlights","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"@context":{"type":"array","prefixItems":[{"type":"string","enum":["https://www.w3.org/ns/activitystreams#"]},{"type":"string","enum":["https://konbiniapi.com/ns/social#"]}],"description":"ActivityStreams JSON-LD context","example":["https://www.w3.org/ns/activitystreams#","https://konbiniapi.com/ns/social#"]},"type":{"type":"string","description":"ActivityStreams collection type","example":"OrderedCollectionPage"},"partOf":{"type":"string","format":"uri","description":"URL of the full collection","example":"https://api.konbiniapi.com/v1/instagram/users/khaby00/highlights"},"totalItems":{"type":["integer","null"],"description":"Total number of items, null if unknown","example":1309},"cursor":{"type":["string","null"],"description":"Current page cursor, null on first page","example":null},"nextCursor":{"type":["string","null"],"description":"Cursor for the next page, null on last page","example":"abc123"},"next":{"type":["string","null"],"format":"uri","description":"URL for the next page, null on last page","example":"https://api.konbiniapi.com/v1/instagram/users/khaby00/highlights?cursor=abc123"},"itemCount":{"type":"integer","description":"Number of items returned in this page","example":30},"orderedItems":{"type":"array","items":{"$ref":"#/components/schemas/InstagramHighlight"},"description":"Items in this page"}},"required":["@context","type","partOf","totalItems","cursor","nextCursor","next","itemCount","orderedItems"]}},"required":["data"]}}}},"400":{"description":"Bad Request — Invalid parameters","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["validation_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Validation error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"401":{"description":"Unauthorized — Missing or invalid API key","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["missing_api_key","invalid_api_key"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Invalid API key","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"402":{"description":"Payment Required — Credits exhausted","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["credits_exhausted"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Credits exhausted. Upgrade your plan at konbiniapi.com","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"403":{"description":"Forbidden — API key disabled or expired","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["api_key_disabled","api_key_expired"],"description":"Machine-readable error code"},"message":{"type":"string","example":"API key is disabled","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"404":{"description":"Not Found","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["not_found","route_not_found"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Not found","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"413":{"description":"Content Too Large — Request body exceeds 1 MB","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["validation_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Request body too large","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"500":{"description":"Internal Server Error","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["internal_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Internal error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"502":{"description":"Bad Gateway — Upstream platform error","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["platform_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Platform error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"503":{"description":"Service Unavailable","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["service_unavailable"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Service unavailable","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"504":{"description":"Gateway Timeout — Upstream platform timed out","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["platform_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Platform error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}}}}},"/v1/instagram/posts/{postId}":{"get":{"operationId":"instagramGetPost","tags":["Instagram"],"summary":"Get post details","description":"Returns details for a single post by its shortcode, including media, captions, and engagement counts. Supports photos, videos, and carousels.","parameters":[{"schema":{"type":"string","description":"Post shortcode (from instagram.com/p/{shortcode}/)","example":"DVRYDo-Cjw3"},"required":true,"description":"Post shortcode (from instagram.com/p/{shortcode}/)","name":"postId","in":"path"}],"responses":{"200":{"description":"Returns the Instagram post","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"@context":{"type":"array","prefixItems":[{"type":"string","enum":["https://www.w3.org/ns/activitystreams#"]},{"type":"string","enum":["https://konbiniapi.com/ns/social#"]}],"description":"ActivityStreams JSON-LD context","example":["https://www.w3.org/ns/activitystreams#","https://konbiniapi.com/ns/social#"]},"type":{"type":"string","description":"ActivityStreams object type","example":"Video"},"id":{"type":"string","format":"uri","description":"Post permalink","example":"https://www.instagram.com/p/CybWViruta1/"},"url":{"type":"string","format":"uri","description":"Post URL","example":"https://www.instagram.com/p/CybWViruta1/"},"entityId":{"type":"string","description":"Post shortcode (used as lookup key)","example":"CybWViruta1"},"content":{"type":"string","description":"Caption or description","example":"When you realize there is a simpler way #learnfromkhaby"},"published":{"type":"string","format":"date-time","description":"Publication date in ISO 8601 format","example":"2026-02-27T18:36:42.000Z"},"likeCount":{"type":"integer","description":"Number of likes","example":2800000},"commentCount":{"type":"integer","description":"Number of comments","example":29200},"attributedTo":{"anyOf":[{"$ref":"#/components/schemas/InstagramEmbeddedUser"},{"type":"array","items":{"$ref":"#/components/schemas/InstagramEmbeddedUser"}}],"description":"Post author or collaborators"},"location":{"$ref":"#/components/schemas/InstagramLocation","description":"Post location tag"},"tag":{"type":"array","items":{"$ref":"#/components/schemas/InstagramTag"},"description":"Tagged users or hashtags"},"language":{"type":"string","description":"Content language (BCP47 code)","example":"en"},"isEdited":{"type":"boolean","description":"Whether the caption has been edited","example":false},"isSponsored":{"type":"boolean","description":"Whether post is a paid partnership","example":false},"viewCount":{"type":"integer","description":"Number of views","example":42600000},"duration":{"type":"number","description":"Duration in seconds","example":23},"contentFormat":{"type":"string","description":"Content format (e.g. video, reel, igtv)","example":"reel"},"attachment":{"type":"array","items":{"$ref":"#/components/schemas/InstagramAttachment"},"description":"Media files"},"image":{"type":"array","items":{"$ref":"#/components/schemas/InstagramImageWithDimensions"},"description":"Post images"},"audio":{"$ref":"#/components/schemas/InstagramAudio","description":"Post audio track"},"name":{"type":"string","description":"Alt text or accessibility caption","example":"Photo of Khabane Lame"},"totalItems":{"type":"integer","description":"Number of carousel items","example":5},"items":{"type":"array","items":{"$ref":"#/components/schemas/InstagramCarouselItem"},"description":"Carousel slides"}},"required":["@context","type","id","url","entityId"]}},"required":["data"]}}}},"400":{"description":"Bad Request — Invalid parameters","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["validation_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Validation error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"401":{"description":"Unauthorized — Missing or invalid API key","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["missing_api_key","invalid_api_key"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Invalid API key","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"402":{"description":"Payment Required — Credits exhausted","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["credits_exhausted"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Credits exhausted. Upgrade your plan at konbiniapi.com","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"403":{"description":"Forbidden — API key disabled or expired","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["api_key_disabled","api_key_expired"],"description":"Machine-readable error code"},"message":{"type":"string","example":"API key is disabled","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"404":{"description":"Not Found","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["not_found","route_not_found"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Not found","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"413":{"description":"Content Too Large — Request body exceeds 1 MB","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["validation_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Request body too large","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"500":{"description":"Internal Server Error","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["internal_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Internal error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"502":{"description":"Bad Gateway — Upstream platform error","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["platform_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Platform error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"503":{"description":"Service Unavailable","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["service_unavailable"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Service unavailable","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"504":{"description":"Gateway Timeout — Upstream platform timed out","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["platform_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Platform error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}}}}},"/v1/instagram/posts/{postId}/comments":{"get":{"operationId":"instagramGetPostComments","tags":["Instagram"],"summary":"Get post comments","description":"Returns top-level comments on an Instagram post. Fixed page size of 15 (platform limit). Includes comment text, author info, like counts, and timestamps.","parameters":[{"schema":{"type":"string","description":"Post shortcode (from instagram.com/p/{shortcode}/)","example":"DVRYDo-Cjw3"},"required":true,"description":"Post shortcode (from instagram.com/p/{shortcode}/)","name":"postId","in":"path"},{"schema":{"type":"integer","minimum":15,"maximum":15,"default":15,"description":"Page size (fixed at 15 by the platform)","example":15},"required":false,"description":"Page size (fixed at 15 by the platform)","name":"count","in":"query"},{"schema":{"type":"string","description":"Pagination cursor","example":"0"},"required":false,"description":"Pagination cursor","name":"cursor","in":"query"}],"responses":{"200":{"description":"Returns the post comments","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"@context":{"type":"array","prefixItems":[{"type":"string","enum":["https://www.w3.org/ns/activitystreams#"]},{"type":"string","enum":["https://konbiniapi.com/ns/social#"]}],"description":"ActivityStreams JSON-LD context","example":["https://www.w3.org/ns/activitystreams#","https://konbiniapi.com/ns/social#"]},"type":{"type":"string","description":"ActivityStreams collection type","example":"OrderedCollectionPage"},"partOf":{"type":"string","format":"uri","description":"URL of the full collection","example":"https://api.konbiniapi.com/v1/instagram/posts/CybWViruta1/comments"},"totalItems":{"type":["integer","null"],"description":"Total number of items, null if unknown","example":1309},"cursor":{"type":["string","null"],"description":"Current page cursor, null on first page","example":null},"nextCursor":{"type":["string","null"],"description":"Cursor for the next page, null on last page","example":"abc123"},"next":{"type":["string","null"],"format":"uri","description":"URL for the next page, null on last page","example":"https://api.konbiniapi.com/v1/instagram/posts/CybWViruta1/comments?cursor=abc123&count=15"},"itemCount":{"type":"integer","description":"Number of items returned in this page","example":30},"orderedItems":{"type":"array","items":{"$ref":"#/components/schemas/InstagramComment"},"description":"Items in this page"}},"required":["@context","type","partOf","totalItems","cursor","nextCursor","next","itemCount","orderedItems"]}},"required":["data"]}}}},"400":{"description":"Bad Request — Invalid parameters","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["validation_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Validation error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"401":{"description":"Unauthorized — Missing or invalid API key","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["missing_api_key","invalid_api_key"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Invalid API key","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"402":{"description":"Payment Required — Credits exhausted","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["credits_exhausted"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Credits exhausted. Upgrade your plan at konbiniapi.com","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"403":{"description":"Forbidden — API key disabled or expired","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["api_key_disabled","api_key_expired"],"description":"Machine-readable error code"},"message":{"type":"string","example":"API key is disabled","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"404":{"description":"Not Found","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["not_found","route_not_found"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Not found","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"413":{"description":"Content Too Large — Request body exceeds 1 MB","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["validation_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Request body too large","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"500":{"description":"Internal Server Error","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["internal_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Internal error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"502":{"description":"Bad Gateway — Upstream platform error","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["platform_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Platform error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"503":{"description":"Service Unavailable","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["service_unavailable"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Service unavailable","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"504":{"description":"Gateway Timeout — Upstream platform timed out","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["platform_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Platform error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}}}}},"/v1/instagram/search":{"get":{"operationId":"instagramSearchMedia","tags":["Instagram"],"summary":"Search media","description":"Searches Instagram for trending reels and videos matching a keyword. Maximum 24 results per page. Some valid keywords may return no results, since this surfaces trending content rather than a full-text search.","parameters":[{"schema":{"type":"string","minLength":1,"description":"Search query","example":"music"},"required":true,"description":"Search query","name":"query","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":24,"default":24,"description":"Number of results to fetch (maximum: 24)","example":24},"required":false,"description":"Number of results to fetch (maximum: 24)","name":"count","in":"query"},{"schema":{"type":"string","description":"Pagination cursor","example":"0"},"required":false,"description":"Pagination cursor","name":"cursor","in":"query"}],"responses":{"200":{"description":"Returns search results (reels/videos)","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"@context":{"type":"array","prefixItems":[{"type":"string","enum":["https://www.w3.org/ns/activitystreams#"]},{"type":"string","enum":["https://konbiniapi.com/ns/social#"]}],"description":"ActivityStreams JSON-LD context","example":["https://www.w3.org/ns/activitystreams#","https://konbiniapi.com/ns/social#"]},"type":{"type":"string","description":"ActivityStreams collection type","example":"OrderedCollectionPage"},"partOf":{"type":"string","format":"uri","description":"URL of the full collection","example":"https://api.konbiniapi.com/v1/instagram/search"},"totalItems":{"type":["integer","null"],"description":"Total number of items, null if unknown","example":1309},"cursor":{"type":["string","null"],"description":"Current page cursor, null on first page","example":null},"nextCursor":{"type":["string","null"],"description":"Cursor for the next page, null on last page","example":"abc123"},"next":{"type":["string","null"],"format":"uri","description":"URL for the next page, null on last page","example":"https://api.konbiniapi.com/v1/instagram/search?query=music&cursor=abc123&count=24"},"itemCount":{"type":"integer","description":"Number of items returned in this page","example":30},"orderedItems":{"type":"array","items":{"$ref":"#/components/schemas/InstagramPost"},"description":"Items in this page"}},"required":["@context","type","partOf","totalItems","cursor","nextCursor","next","itemCount","orderedItems"]}},"required":["data"]}}}},"400":{"description":"Bad Request — Invalid parameters","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["validation_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Validation error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"401":{"description":"Unauthorized — Missing or invalid API key","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["missing_api_key","invalid_api_key"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Invalid API key","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"402":{"description":"Payment Required — Credits exhausted","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["credits_exhausted"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Credits exhausted. Upgrade your plan at konbiniapi.com","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"403":{"description":"Forbidden — API key disabled or expired","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["api_key_disabled","api_key_expired"],"description":"Machine-readable error code"},"message":{"type":"string","example":"API key is disabled","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"404":{"description":"Not Found","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["not_found","route_not_found"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Not found","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"413":{"description":"Content Too Large — Request body exceeds 1 MB","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["validation_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Request body too large","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"500":{"description":"Internal Server Error","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["internal_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Internal error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"502":{"description":"Bad Gateway — Upstream platform error","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["platform_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Platform error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"503":{"description":"Service Unavailable","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["service_unavailable"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Service unavailable","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"504":{"description":"Gateway Timeout — Upstream platform timed out","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["platform_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Platform error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}}}}},"/v1/instagram/locations/{locationId}":{"get":{"operationId":"instagramGetLocationPosts","tags":["Instagram"],"summary":"Get posts by location","description":"Returns recent posts tagged at a location. Fixed page size of 21 (platform limit). The location ID is a numeric Facebook Places ID.","parameters":[{"schema":{"type":"string","description":"Instagram/Facebook location ID (numeric)","example":"212999109"},"required":true,"description":"Instagram/Facebook location ID (numeric)","name":"locationId","in":"path"},{"schema":{"type":"integer","minimum":21,"maximum":21,"default":21,"description":"Page size (fixed at 21 by the platform)","example":21},"required":false,"description":"Page size (fixed at 21 by the platform)","name":"count","in":"query"},{"schema":{"type":"string","description":"Pagination cursor","example":"0"},"required":false,"description":"Pagination cursor","name":"cursor","in":"query"}],"responses":{"200":{"description":"Returns posts from this location","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"@context":{"type":"array","prefixItems":[{"type":"string","enum":["https://www.w3.org/ns/activitystreams#"]},{"type":"string","enum":["https://konbiniapi.com/ns/social#"]}],"description":"ActivityStreams JSON-LD context","example":["https://www.w3.org/ns/activitystreams#","https://konbiniapi.com/ns/social#"]},"type":{"type":"string","description":"ActivityStreams collection type","example":"OrderedCollectionPage"},"partOf":{"type":"string","format":"uri","description":"URL of the full collection","example":"https://api.konbiniapi.com/v1/instagram/locations/213385402/posts"},"totalItems":{"type":["integer","null"],"description":"Total number of items, null if unknown","example":1309},"cursor":{"type":["string","null"],"description":"Current page cursor, null on first page","example":null},"nextCursor":{"type":["string","null"],"description":"Cursor for the next page, null on last page","example":"abc123"},"next":{"type":["string","null"],"format":"uri","description":"URL for the next page, null on last page","example":"https://api.konbiniapi.com/v1/instagram/locations/213385402/posts?cursor=abc123&count=21"},"itemCount":{"type":"integer","description":"Number of items returned in this page","example":30},"orderedItems":{"type":"array","items":{"$ref":"#/components/schemas/InstagramPost"},"description":"Items in this page"}},"required":["@context","type","partOf","totalItems","cursor","nextCursor","next","itemCount","orderedItems"]}},"required":["data"]}}}},"400":{"description":"Bad Request — Invalid parameters","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["validation_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Validation error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"401":{"description":"Unauthorized — Missing or invalid API key","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["missing_api_key","invalid_api_key"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Invalid API key","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"402":{"description":"Payment Required — Credits exhausted","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["credits_exhausted"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Credits exhausted. Upgrade your plan at konbiniapi.com","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"403":{"description":"Forbidden — API key disabled or expired","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["api_key_disabled","api_key_expired"],"description":"Machine-readable error code"},"message":{"type":"string","example":"API key is disabled","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"404":{"description":"Not Found","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["not_found","route_not_found"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Not found","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"413":{"description":"Content Too Large — Request body exceeds 1 MB","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["validation_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Request body too large","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"500":{"description":"Internal Server Error","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["internal_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Internal error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"502":{"description":"Bad Gateway — Upstream platform error","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["platform_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Platform error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"503":{"description":"Service Unavailable","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["service_unavailable"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Service unavailable","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"504":{"description":"Gateway Timeout — Upstream platform timed out","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["platform_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Platform error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}}}}},"/v1/instagram/highlights/{highlightId}":{"get":{"operationId":"instagramGetHighlightStories","tags":["Instagram"],"summary":"Get highlight stories","description":"Returns all story items within a highlight reel, including images and videos. The highlight ID comes from the highlights list endpoint.","parameters":[{"schema":{"type":"string","description":"Instagram highlight ID","example":"17931388058310575"},"required":true,"description":"Instagram highlight ID","name":"highlightId","in":"path"}],"responses":{"200":{"description":"Returns the highlight with all story items","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"@context":{"type":"array","prefixItems":[{"type":"string","enum":["https://www.w3.org/ns/activitystreams#"]},{"type":"string","enum":["https://konbiniapi.com/ns/social#"]}],"description":"ActivityStreams JSON-LD context","example":["https://www.w3.org/ns/activitystreams#","https://konbiniapi.com/ns/social#"]},"type":{"type":"string","description":"ActivityStreams object type","example":"OrderedCollection"},"id":{"type":"string","format":"uri","description":"Collection permalink","example":"https://www.instagram.com/stories/highlights/17890000000000001/"},"entityId":{"type":"string","description":"Instagram internal highlight ID","example":"highlight:17890000000000001"},"name":{"type":"string","description":"Collection name","example":"Best of 2025"},"image":{"type":"array","items":{"$ref":"#/components/schemas/InstagramImage"},"description":"Highlight cover images"},"totalItems":{"type":["integer","null"],"description":"Number of items in collection","example":42},"orderedItems":{"type":"array","items":{"$ref":"#/components/schemas/InstagramStoryItem"},"description":"Story items in this highlight"}},"required":["@context","type","id","entityId","totalItems","orderedItems"]}},"required":["data"]}}}},"400":{"description":"Bad Request — Invalid parameters","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["validation_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Validation error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"401":{"description":"Unauthorized — Missing or invalid API key","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["missing_api_key","invalid_api_key"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Invalid API key","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"402":{"description":"Payment Required — Credits exhausted","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["credits_exhausted"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Credits exhausted. Upgrade your plan at konbiniapi.com","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"403":{"description":"Forbidden — API key disabled or expired","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["api_key_disabled","api_key_expired"],"description":"Machine-readable error code"},"message":{"type":"string","example":"API key is disabled","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"404":{"description":"Not Found","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["not_found","route_not_found"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Not found","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"413":{"description":"Content Too Large — Request body exceeds 1 MB","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["validation_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Request body too large","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"500":{"description":"Internal Server Error","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["internal_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Internal error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"502":{"description":"Bad Gateway — Upstream platform error","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["platform_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Platform error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"503":{"description":"Service Unavailable","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["service_unavailable"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Service unavailable","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"504":{"description":"Gateway Timeout — Upstream platform timed out","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["platform_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Platform error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}}}}},"/v1/x/users/{username}":{"get":{"operationId":"xGetUser","tags":["X"],"summary":"Get user profile","description":"Returns profile information for a public X account including bio, follower counts, verification flags, and profile images.","parameters":[{"schema":{"type":"string","description":"X username (with or without @ symbol)","example":"Austen"},"required":true,"description":"X username (with or without @ symbol)","name":"username","in":"path"}],"responses":{"200":{"description":"Returns the X user profile","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"@context":{"type":"array","prefixItems":[{"type":"string","enum":["https://www.w3.org/ns/activitystreams#"]},{"type":"string","enum":["https://konbiniapi.com/ns/social#"]}],"description":"ActivityStreams JSON-LD context","example":["https://www.w3.org/ns/activitystreams#","https://konbiniapi.com/ns/social#"]},"type":{"type":"string","description":"ActivityStreams object type","example":"Person"},"id":{"type":"string","format":"uri","description":"Profile URL","example":"https://x.com/KhabyLame"},"url":{"type":"string","format":"uri","description":"Profile URL","example":"https://x.com/KhabyLame"},"entityId":{"type":"string","description":"X user ID","example":"1379925457689268227"},"name":{"type":"string","description":"Display name","example":"Khaby lame"},"preferredUsername":{"type":"string","description":"Username or handle","example":"KhabyLame"},"summary":{"type":"string","description":"Bio text","example":"Let's Go"},"attachment":{"type":"array","items":{"$ref":"#/components/schemas/XLink"},"description":"Profile links"},"published":{"type":"string","format":"date-time","description":"Account creation date in ISO 8601 format","example":"2010-12-01T19:13:23.000Z"},"isPrivate":{"type":"boolean","description":"Whether account is protected","example":false},"isVerified":{"type":"boolean","description":"Whether account has legacy verification","example":false},"isPaidVerified":{"type":"boolean","description":"Whether account has X Premium verification","example":true},"followerCount":{"type":"integer","description":"Number of followers","example":372131},"followingCount":{"type":"integer","description":"Number of accounts followed","example":8},"likeCount":{"type":"integer","description":"Number of likes made by the user","example":60},"postCount":{"type":"integer","description":"Number of public posts","example":267},"mediaCount":{"type":"integer","description":"Number of media posts","example":242},"listedCount":{"type":"integer","description":"Number of public X Lists the account appears in","example":215},"location":{"type":"string","description":"User location","example":"Chivasso, Italy"},"icon":{"$ref":"#/components/schemas/XImage"},"image":{"type":"array","items":{"allOf":[{"$ref":"#/components/schemas/XImage"},{"description":"Image resource with optional dimensions"}]},"description":"Banner image and other non-avatar profile images"}},"required":["@context","type","id","url","entityId","name","preferredUsername","isPrivate","isVerified","isPaidVerified","followerCount","followingCount","likeCount","postCount","mediaCount"]}},"required":["data"]}}}},"400":{"description":"Bad Request — Invalid parameters","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["validation_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Validation error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"401":{"description":"Unauthorized — Missing or invalid API key","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["missing_api_key","invalid_api_key"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Invalid API key","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"402":{"description":"Payment Required — Credits exhausted","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["credits_exhausted"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Credits exhausted. Upgrade your plan at konbiniapi.com","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"403":{"description":"Forbidden — API key disabled or expired","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["api_key_disabled","api_key_expired"],"description":"Machine-readable error code"},"message":{"type":"string","example":"API key is disabled","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"404":{"description":"Not Found","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["not_found","route_not_found"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Not found","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"413":{"description":"Content Too Large — Request body exceeds 1 MB","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["validation_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Request body too large","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"500":{"description":"Internal Server Error","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["internal_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Internal error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"502":{"description":"Bad Gateway — Upstream platform error","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["platform_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Platform error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"503":{"description":"Service Unavailable","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["service_unavailable"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Service unavailable","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"504":{"description":"Gateway Timeout — Upstream platform timed out","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["platform_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Platform error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}}}}},"/v1/x/users/{username}/posts":{"get":{"operationId":"xGetUserPosts","tags":["X"],"summary":"Get user posts","description":"Returns public posts from a user's profile as visible to not logged in users. This feed is not guaranteed to be chronological and is often a ranked public selection. Pages may overlap: a pinned post is repeated on every page, so deduplicate by id when paging.","parameters":[{"schema":{"type":"string","description":"X username (with or without @ symbol)","example":"Austen"},"required":true,"description":"X username (with or without @ symbol)","name":"username","in":"path"},{"schema":{"type":"string","description":"Pagination cursor","example":"0"},"required":false,"description":"Pagination cursor","name":"cursor","in":"query"}],"responses":{"200":{"description":"Returns public posts from an X user profile","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"@context":{"type":"array","prefixItems":[{"type":"string","enum":["https://www.w3.org/ns/activitystreams#"]},{"type":"string","enum":["https://konbiniapi.com/ns/social#"]}],"description":"ActivityStreams JSON-LD context","example":["https://www.w3.org/ns/activitystreams#","https://konbiniapi.com/ns/social#"]},"type":{"type":"string","description":"ActivityStreams collection type","example":"OrderedCollectionPage"},"partOf":{"type":"string","format":"uri","description":"URL of the full collection","example":"https://api.konbiniapi.com/v1/x/users/KhabyLame/posts"},"totalItems":{"type":["integer","null"],"description":"Total number of items, null if unknown","example":null},"cursor":{"type":["string","null"],"description":"Current page cursor, null on first page","example":null},"nextCursor":{"type":["string","null"],"description":"Cursor for the next page, null on last page","example":"DAABCgABHOkX2xF__-8LAAIAAAATMj"},"next":{"type":["string","null"],"format":"uri","description":"URL for the next page, null on last page","example":"https://api.konbiniapi.com/v1/x/users/KhabyLame/posts?cursor=DAABCgABHOkX2xF__-8LAAIAAAATMj"},"itemCount":{"type":"integer","description":"Number of items returned in this page","example":30},"orderedItems":{"type":"array","items":{"$ref":"#/components/schemas/XPost"},"description":"Items in this page"}},"required":["@context","type","partOf","totalItems","cursor","nextCursor","next","itemCount","orderedItems"]}},"required":["data"]}}}},"400":{"description":"Bad Request — Invalid parameters","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["validation_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Validation error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"401":{"description":"Unauthorized — Missing or invalid API key","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["missing_api_key","invalid_api_key"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Invalid API key","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"402":{"description":"Payment Required — Credits exhausted","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["credits_exhausted"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Credits exhausted. Upgrade your plan at konbiniapi.com","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"403":{"description":"Forbidden — API key disabled or expired","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["api_key_disabled","api_key_expired"],"description":"Machine-readable error code"},"message":{"type":"string","example":"API key is disabled","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"404":{"description":"Not Found","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["not_found","route_not_found"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Not found","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"413":{"description":"Content Too Large — Request body exceeds 1 MB","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["validation_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Request body too large","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"500":{"description":"Internal Server Error","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["internal_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Internal error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"502":{"description":"Bad Gateway — Upstream platform error","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["platform_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Platform error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"503":{"description":"Service Unavailable","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["service_unavailable"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Service unavailable","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"504":{"description":"Gateway Timeout — Upstream platform timed out","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["platform_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Platform error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}}}}},"/v1/x/users/{username}/highlights":{"get":{"operationId":"xGetUserHighlights","tags":["X"],"summary":"Get user highlights","description":"Returns the public Highlights tab selection as visible to not logged in users. This feed is not guaranteed to be chronological. Pages may overlap: a pinned post is repeated on every page, so deduplicate by id when paging.","parameters":[{"schema":{"type":"string","description":"X username (with or without @ symbol)","example":"Austen"},"required":true,"description":"X username (with or without @ symbol)","name":"username","in":"path"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":40,"description":"Number of highlighted posts to return per page (maximum: 100)","example":40},"required":false,"description":"Number of highlighted posts to return per page (maximum: 100)","name":"count","in":"query"},{"schema":{"type":"string","description":"Pagination cursor","example":"0"},"required":false,"description":"Pagination cursor","name":"cursor","in":"query"}],"responses":{"200":{"description":"Returns the public Highlights tab selection from an X user's profile","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"@context":{"type":"array","prefixItems":[{"type":"string","enum":["https://www.w3.org/ns/activitystreams#"]},{"type":"string","enum":["https://konbiniapi.com/ns/social#"]}],"description":"ActivityStreams JSON-LD context","example":["https://www.w3.org/ns/activitystreams#","https://konbiniapi.com/ns/social#"]},"type":{"type":"string","description":"ActivityStreams collection type","example":"OrderedCollectionPage"},"partOf":{"type":"string","format":"uri","description":"URL of the full collection","example":"https://api.konbiniapi.com/v1/x/users/KhabyLame/highlights"},"totalItems":{"type":["integer","null"],"description":"Total number of items, null if unknown","example":null},"cursor":{"type":["string","null"],"description":"Current page cursor, null on first page","example":null},"nextCursor":{"type":["string","null"],"description":"Cursor for the next page, null on last page","example":"DAABCgABHOkX2xF__-8LAAIAAAATMj"},"next":{"type":["string","null"],"format":"uri","description":"URL for the next page, null on last page","example":"https://api.konbiniapi.com/v1/x/users/KhabyLame/highlights?cursor=DAABCgABHOkX2xF__-8LAAIAAAATMj&count=40"},"itemCount":{"type":"integer","description":"Number of items returned in this page","example":30},"orderedItems":{"type":"array","items":{"$ref":"#/components/schemas/XPost"},"description":"Items in this page"}},"required":["@context","type","partOf","totalItems","cursor","nextCursor","next","itemCount","orderedItems"]}},"required":["data"]}}}},"400":{"description":"Bad Request — Invalid parameters","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["validation_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Validation error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"401":{"description":"Unauthorized — Missing or invalid API key","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["missing_api_key","invalid_api_key"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Invalid API key","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"402":{"description":"Payment Required — Credits exhausted","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["credits_exhausted"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Credits exhausted. Upgrade your plan at konbiniapi.com","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"403":{"description":"Forbidden — API key disabled or expired","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["api_key_disabled","api_key_expired"],"description":"Machine-readable error code"},"message":{"type":"string","example":"API key is disabled","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"404":{"description":"Not Found","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["not_found","route_not_found"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Not found","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"413":{"description":"Content Too Large — Request body exceeds 1 MB","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["validation_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Request body too large","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"500":{"description":"Internal Server Error","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["internal_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Internal error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"502":{"description":"Bad Gateway — Upstream platform error","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["platform_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Platform error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"503":{"description":"Service Unavailable","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["service_unavailable"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Service unavailable","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"504":{"description":"Gateway Timeout — Upstream platform timed out","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["platform_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Platform error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}}}}},"/v1/x/posts/{postId}":{"get":{"operationId":"xGetPost","tags":["X"],"summary":"Get post","description":"Returns a public X post including text, author, engagement counts, and media attachments.","parameters":[{"schema":{"type":"string","description":"X post ID","example":"1935730646267158797"},"required":true,"description":"X post ID","name":"postId","in":"path"}],"responses":{"200":{"description":"Returns the X post","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"@context":{"type":"array","prefixItems":[{"type":"string","enum":["https://www.w3.org/ns/activitystreams#"]},{"type":"string","enum":["https://konbiniapi.com/ns/social#"]}],"description":"ActivityStreams JSON-LD context","example":["https://www.w3.org/ns/activitystreams#","https://konbiniapi.com/ns/social#"]},"type":{"type":"string","description":"ActivityStreams object type","example":"Note"},"id":{"type":"string","format":"uri","description":"Post permalink","example":"https://x.com/KhabyLame/status/2024515585569083437"},"url":{"type":"string","format":"uri","description":"Post permalink","example":"https://x.com/KhabyLame/status/2024515585569083437"},"entityId":{"type":"string","description":"X post ID","example":"2024515585569083437"},"content":{"type":"string","description":"Comment text","example":"This man hasn't been in my fyp for so long"},"published":{"type":"string","format":"date-time","description":"Publication date in ISO 8601 format","example":"2026-02-27T20:37:38.000Z"},"likeCount":{"type":"integer","description":"Number of likes","example":93210},"replyCount":{"type":"integer","description":"Number of replies","example":96},"viewCount":{"type":"integer","description":"Number of views","example":10195},"repostCount":{"type":"integer","description":"Number of reposts/retweets","example":3},"quoteCount":{"type":"integer","description":"Number of quote posts","example":0},"saveCount":{"type":"integer","description":"Number of saves/bookmarks","example":3},"contentFormat":{"type":"string","description":"Content format (`post` for regular posts, `longform` for longer posts)","example":"longform"},"isEdited":{"type":"boolean","description":"Whether the post has been edited","example":false},"attributedTo":{"$ref":"#/components/schemas/XEmbeddedUser"},"inReplyTo":{"type":"string","format":"uri","description":"URL of parent content","example":"https://x.com/NISMO/status/2024100000000000000"},"quote":{"$ref":"#/components/schemas/XQuotedPost"},"image":{"type":"array","items":{"allOf":[{"$ref":"#/components/schemas/XImage"},{"description":"Image resource with optional dimensions"}]},"description":"Primary images and thumbnails"},"attachment":{"type":"array","items":{"$ref":"#/components/schemas/XPostAttachment"},"description":"Media, poll, and preview attachments"},"tag":{"type":"array","items":{"$ref":"#/components/schemas/XTag"},"description":"Hashtags and mentions"}},"required":["@context","type","id","url","entityId","content","likeCount"]}},"required":["data"]}}}},"400":{"description":"Bad Request — Invalid parameters","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["validation_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Validation error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"401":{"description":"Unauthorized — Missing or invalid API key","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["missing_api_key","invalid_api_key"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Invalid API key","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"402":{"description":"Payment Required — Credits exhausted","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["credits_exhausted"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Credits exhausted. Upgrade your plan at konbiniapi.com","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"403":{"description":"Forbidden — API key disabled or expired","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["api_key_disabled","api_key_expired"],"description":"Machine-readable error code"},"message":{"type":"string","example":"API key is disabled","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"404":{"description":"Not Found","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["not_found","route_not_found"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Not found","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"413":{"description":"Content Too Large — Request body exceeds 1 MB","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["validation_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Request body too large","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"500":{"description":"Internal Server Error","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["internal_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Internal error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"502":{"description":"Bad Gateway — Upstream platform error","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["platform_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Platform error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"503":{"description":"Service Unavailable","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["service_unavailable"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Service unavailable","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"504":{"description":"Gateway Timeout — Upstream platform timed out","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["platform_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Platform error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}}}}},"/v1/x/communities/{communityId}":{"get":{"operationId":"xGetCommunity","tags":["X"],"summary":"Get community","description":"Returns public metadata for an X community, including description, member count, topic, creator, and banner image.","parameters":[{"schema":{"type":"string","description":"X community ID","example":"1669501013441806336"},"required":true,"description":"X community ID","name":"communityId","in":"path"}],"responses":{"200":{"description":"Returns the X community detail","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"@context":{"type":"array","prefixItems":[{"type":"string","enum":["https://www.w3.org/ns/activitystreams#"]},{"type":"string","enum":["https://konbiniapi.com/ns/social#"]}],"description":"ActivityStreams JSON-LD context","example":["https://www.w3.org/ns/activitystreams#","https://konbiniapi.com/ns/social#"]},"type":{"type":"string","description":"ActivityStreams object type","example":"Group"},"id":{"type":"string","format":"uri","description":"Community URL","example":"https://x.com/i/communities/1669501013441806336"},"url":{"type":"string","format":"uri","description":"Community URL","example":"https://x.com/i/communities/1669501013441806336"},"entityId":{"type":"string","description":"X community ID","example":"1669501013441806336"},"name":{"type":"string","description":"Community name","example":"Memes"},"summary":{"type":"string","description":"Community description","example":"Post the funniest memes you can find!"},"published":{"type":"string","format":"date-time","description":"Community creation date in ISO 8601 format","example":"2023-06-16T00:23:54.093Z"},"memberCount":{"type":"integer","description":"Number of community members","example":515319},"category":{"type":"string","description":"Primary community topic","example":"Entertainment"},"tag":{"type":"array","items":{"$ref":"#/components/schemas/XTag"},"description":"Trending hashtags associated with the community"},"rule":{"type":"array","items":{"$ref":"#/components/schemas/XCommunityRule"},"description":"Community rules"},"attributedTo":{"allOf":[{"$ref":"#/components/schemas/XEmbeddedUser"},{"description":"Compact X profile for embedded contexts"}],"description":"Community creator"},"image":{"type":"array","items":{"allOf":[{"$ref":"#/components/schemas/XImage"},{"description":"Image resource with optional dimensions"}]},"description":"Community banner images"}},"required":["@context","type","id","url","entityId","name"]}},"required":["data"]}}}},"400":{"description":"Bad Request — Invalid parameters","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["validation_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Validation error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"401":{"description":"Unauthorized — Missing or invalid API key","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["missing_api_key","invalid_api_key"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Invalid API key","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"402":{"description":"Payment Required — Credits exhausted","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["credits_exhausted"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Credits exhausted. Upgrade your plan at konbiniapi.com","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"403":{"description":"Forbidden — API key disabled or expired","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["api_key_disabled","api_key_expired"],"description":"Machine-readable error code"},"message":{"type":"string","example":"API key is disabled","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"404":{"description":"Not Found","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["not_found","route_not_found"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Not found","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"413":{"description":"Content Too Large — Request body exceeds 1 MB","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["validation_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Request body too large","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"500":{"description":"Internal Server Error","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["internal_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Internal error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"502":{"description":"Bad Gateway — Upstream platform error","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["platform_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Platform error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"503":{"description":"Service Unavailable","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["service_unavailable"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Service unavailable","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"504":{"description":"Gateway Timeout — Upstream platform timed out","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["platform_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Platform error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}}}}},"/v1/x/communities/{communityId}/posts":{"get":{"operationId":"xGetCommunityPosts","tags":["X"],"summary":"Get community posts","description":"Returns public posts from an X community timeline as visible to not logged in users.","parameters":[{"schema":{"type":"string","description":"X community ID","example":"1669501013441806336"},"required":true,"description":"X community ID","name":"communityId","in":"path"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":40,"description":"Maximum number of posts to return from the community timeline (maximum: 100)","example":40},"required":false,"description":"Maximum number of posts to return from the community timeline (maximum: 100)","name":"count","in":"query"},{"schema":{"type":"string","description":"Pagination cursor","example":"0"},"required":false,"description":"Pagination cursor","name":"cursor","in":"query"}],"responses":{"200":{"description":"Returns posts from an X community timeline","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"@context":{"type":"array","prefixItems":[{"type":"string","enum":["https://www.w3.org/ns/activitystreams#"]},{"type":"string","enum":["https://konbiniapi.com/ns/social#"]}],"description":"ActivityStreams JSON-LD context","example":["https://www.w3.org/ns/activitystreams#","https://konbiniapi.com/ns/social#"]},"type":{"type":"string","description":"ActivityStreams collection type","example":"OrderedCollectionPage"},"partOf":{"type":"string","format":"uri","description":"URL of the full collection","example":"https://api.konbiniapi.com/v1/x/communities/1669501013441806336/posts"},"totalItems":{"type":["integer","null"],"description":"Total number of items, null if unknown","example":null},"cursor":{"type":["string","null"],"description":"Current page cursor, null on first page","example":null},"nextCursor":{"type":["string","null"],"description":"Cursor for the next page, null on last page","example":"DAABCgABHOkX2xF__-8LAAIAAAATMj"},"next":{"type":["string","null"],"format":"uri","description":"URL for the next page, null on last page","example":"https://api.konbiniapi.com/v1/x/communities/1669501013441806336/posts?cursor=DAABCgABHOkX2xF__-8LAAIAAAATMj&count=40"},"itemCount":{"type":"integer","description":"Number of items returned in this page","example":30},"orderedItems":{"type":"array","items":{"$ref":"#/components/schemas/XPost"},"description":"Items in this page"}},"required":["@context","type","partOf","totalItems","cursor","nextCursor","next","itemCount","orderedItems"]}},"required":["data"]}}}},"400":{"description":"Bad Request — Invalid parameters","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["validation_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Validation error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"401":{"description":"Unauthorized — Missing or invalid API key","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["missing_api_key","invalid_api_key"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Invalid API key","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"402":{"description":"Payment Required — Credits exhausted","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["credits_exhausted"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Credits exhausted. Upgrade your plan at konbiniapi.com","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"403":{"description":"Forbidden — API key disabled or expired","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["api_key_disabled","api_key_expired"],"description":"Machine-readable error code"},"message":{"type":"string","example":"API key is disabled","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"404":{"description":"Not Found","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["not_found","route_not_found"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Not found","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"413":{"description":"Content Too Large — Request body exceeds 1 MB","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["validation_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Request body too large","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"500":{"description":"Internal Server Error","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["internal_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Internal error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"502":{"description":"Bad Gateway — Upstream platform error","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["platform_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Platform error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"503":{"description":"Service Unavailable","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["service_unavailable"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Service unavailable","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"504":{"description":"Gateway Timeout — Upstream platform timed out","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["platform_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Platform error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}}}}},"/v1/x/communities/{communityId}/media":{"get":{"operationId":"xGetCommunityMedia","tags":["X"],"summary":"Get community media","description":"Returns public posts from an X community's Media tab as visible to not logged in users.","parameters":[{"schema":{"type":"string","description":"X community ID","example":"1669501013441806336"},"required":true,"description":"X community ID","name":"communityId","in":"path"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":40,"description":"Maximum number of media posts to return from the community media timeline (maximum: 100)","example":40},"required":false,"description":"Maximum number of media posts to return from the community media timeline (maximum: 100)","name":"count","in":"query"},{"schema":{"type":"string","description":"Pagination cursor","example":"0"},"required":false,"description":"Pagination cursor","name":"cursor","in":"query"}],"responses":{"200":{"description":"Returns media posts from an X community timeline","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"@context":{"type":"array","prefixItems":[{"type":"string","enum":["https://www.w3.org/ns/activitystreams#"]},{"type":"string","enum":["https://konbiniapi.com/ns/social#"]}],"description":"ActivityStreams JSON-LD context","example":["https://www.w3.org/ns/activitystreams#","https://konbiniapi.com/ns/social#"]},"type":{"type":"string","description":"ActivityStreams collection type","example":"OrderedCollectionPage"},"partOf":{"type":"string","format":"uri","description":"URL of the full collection","example":"https://api.konbiniapi.com/v1/x/communities/1669501013441806336/media"},"totalItems":{"type":["integer","null"],"description":"Total number of items, null if unknown","example":null},"cursor":{"type":["string","null"],"description":"Current page cursor, null on first page","example":null},"nextCursor":{"type":["string","null"],"description":"Cursor for the next page, null on last page","example":"DAABCgABHOkX2xF__-8LAAIAAAATMj"},"next":{"type":["string","null"],"format":"uri","description":"URL for the next page, null on last page","example":"https://api.konbiniapi.com/v1/x/communities/1669501013441806336/media?cursor=DAABCgABHOkX2xF__-8LAAIAAAATMj&count=40"},"itemCount":{"type":"integer","description":"Number of items returned in this page","example":30},"orderedItems":{"type":"array","items":{"$ref":"#/components/schemas/XPost"},"description":"Items in this page"}},"required":["@context","type","partOf","totalItems","cursor","nextCursor","next","itemCount","orderedItems"]}},"required":["data"]}}}},"400":{"description":"Bad Request — Invalid parameters","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["validation_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Validation error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"401":{"description":"Unauthorized — Missing or invalid API key","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["missing_api_key","invalid_api_key"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Invalid API key","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"402":{"description":"Payment Required — Credits exhausted","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["credits_exhausted"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Credits exhausted. Upgrade your plan at konbiniapi.com","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"403":{"description":"Forbidden — API key disabled or expired","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["api_key_disabled","api_key_expired"],"description":"Machine-readable error code"},"message":{"type":"string","example":"API key is disabled","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"404":{"description":"Not Found","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["not_found","route_not_found"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Not found","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"413":{"description":"Content Too Large — Request body exceeds 1 MB","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["validation_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Request body too large","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"500":{"description":"Internal Server Error","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["internal_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Internal error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"502":{"description":"Bad Gateway — Upstream platform error","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["platform_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Platform error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"503":{"description":"Service Unavailable","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["service_unavailable"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Service unavailable","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"504":{"description":"Gateway Timeout — Upstream platform timed out","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["platform_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Platform error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}}}}},"/v1/reddit/users/{username}":{"get":{"operationId":"redditGetUser","tags":["Reddit"],"summary":"Get user profile","description":"Returns public Reddit user profile information including bio, avatar, verification flags, and account creation date.","parameters":[{"schema":{"type":"string","description":"Reddit username (with or without `u/` prefix)","example":"spez"},"required":true,"description":"Reddit username (with or without `u/` prefix)","name":"username","in":"path"}],"responses":{"200":{"description":"Returns the Reddit user profile","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"@context":{"type":"array","prefixItems":[{"type":"string","enum":["https://www.w3.org/ns/activitystreams#"]},{"type":"string","enum":["https://konbiniapi.com/ns/social#"]}],"description":"ActivityStreams JSON-LD context","example":["https://www.w3.org/ns/activitystreams#","https://konbiniapi.com/ns/social#"]},"type":{"type":"string","enum":["Person"]},"id":{"type":"string","format":"uri","description":"Profile URL","example":"https://www.reddit.com/user/spez/"},"url":{"type":"string","format":"uri","description":"Profile URL","example":"https://www.reddit.com/user/spez/"},"entityId":{"type":"string","description":"Platform-specific entity ID","example":"t2_4x25quk"},"preferredUsername":{"type":"string","description":"Username or handle","example":"spez"},"name":{"type":"string","description":"Display name","example":"Steve Huffman"},"icon":{"$ref":"#/components/schemas/RedditImage"},"role":{"type":"string","description":"Role label for distinguished accounts","example":"admin"},"summary":{"type":"string","description":"User bio","example":"Reddit CEO"},"published":{"type":"string","format":"date-time","description":"Account creation date","example":"2005-12-08T07:46:43.000Z"},"isVerified":{"type":"boolean","description":"Whether the account is verified","example":true},"isEmployee":{"type":"boolean","description":"Whether the account belongs to a Reddit employee","example":true},"isMod":{"type":"boolean","description":"Whether the account is a moderator","example":false},"isPremium":{"type":"boolean","description":"Whether the account has a paid premium subscription","example":false},"isSearchable":{"type":"boolean","description":"Whether the profile is visible to search engines","example":true},"isFollowable":{"type":"boolean","description":"Whether the account can be followed","example":true},"isAdult":{"type":"boolean","description":"Whether the profile is marked as adult content","example":false},"score":{"type":"integer","description":"Total Reddit account score","example":999999},"postScore":{"type":"integer","description":"Score earned from Reddit posts","example":555555},"commentScore":{"type":"integer","description":"Score earned from Reddit comments","example":444444},"awarderScore":{"type":"integer","description":"Score earned from giving awards","example":123},"awardeeScore":{"type":"integer","description":"Score earned from receiving awards","example":321},"status":{"type":"string","description":"Account status","example":"active"},"image":{"allOf":[{"$ref":"#/components/schemas/RedditImage"},{"description":"Banner image"}]}},"required":["@context","type","id","url"]}},"required":["data"]}}}},"400":{"description":"Bad Request — Invalid parameters","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["validation_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Validation error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"401":{"description":"Unauthorized — Missing or invalid API key","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["missing_api_key","invalid_api_key"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Invalid API key","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"402":{"description":"Payment Required — Credits exhausted","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["credits_exhausted"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Credits exhausted. Upgrade your plan at konbiniapi.com","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"403":{"description":"Forbidden — API key disabled or expired","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["api_key_disabled","api_key_expired"],"description":"Machine-readable error code"},"message":{"type":"string","example":"API key is disabled","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"404":{"description":"Not Found","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["not_found","route_not_found"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Not found","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"413":{"description":"Content Too Large — Request body exceeds 1 MB","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["validation_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Request body too large","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"500":{"description":"Internal Server Error","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["internal_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Internal error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"502":{"description":"Bad Gateway — Upstream platform error","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["platform_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Platform error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"503":{"description":"Service Unavailable","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["service_unavailable"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Service unavailable","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"504":{"description":"Gateway Timeout — Upstream platform timed out","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["platform_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Platform error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}}}}},"/v1/reddit/users/{username}/posts":{"get":{"operationId":"redditGetUserPosts","tags":["Reddit"],"summary":"Get user posts","description":"Returns public posts submitted by a Reddit user. Supports hot, new, top, and controversial ordering, with optional time windows for top and controversial.","parameters":[{"schema":{"type":"string","description":"Reddit username (with or without `u/` prefix)","example":"spez"},"required":true,"description":"Reddit username (with or without `u/` prefix)","name":"username","in":"path"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":25,"description":"Number of posts to fetch (maximum: 100)","example":25},"required":false,"description":"Number of posts to fetch (maximum: 100)","name":"count","in":"query"},{"schema":{"type":"string","description":"Pagination cursor","example":"0"},"required":false,"description":"Pagination cursor","name":"cursor","in":"query"},{"schema":{"type":"string","enum":["hot","new","top","controversial"],"default":"new","description":"Sort order: new (default), hot, top, or controversial","example":"new"},"required":false,"description":"Sort order: new (default), hot, top, or controversial","name":"order","in":"query"},{"schema":{"type":"string","enum":["hour","day","week","month","year","all"],"description":"Time window for top or controversial ordering: hour, day, week, month, year, or all (default)","example":"week"},"required":false,"description":"Time window for top or controversial ordering: hour, day, week, month, year, or all (default)","name":"time","in":"query"}],"responses":{"200":{"description":"Returns the user posts","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"@context":{"type":"array","prefixItems":[{"type":"string","enum":["https://www.w3.org/ns/activitystreams#"]},{"type":"string","enum":["https://konbiniapi.com/ns/social#"]}],"description":"ActivityStreams JSON-LD context","example":["https://www.w3.org/ns/activitystreams#","https://konbiniapi.com/ns/social#"]},"type":{"type":"string","description":"ActivityStreams collection type","example":"OrderedCollectionPage"},"partOf":{"type":"string","format":"uri","description":"URL of the full collection","example":"https://api.konbiniapi.com/v1/reddit/users/spez/posts"},"totalItems":{"type":["integer","null"],"description":"Total number of items, null if unknown","example":1309},"cursor":{"type":["string","null"],"description":"Current page cursor, null on first page","example":null},"nextCursor":{"type":["string","null"],"description":"Cursor for the next page, null on last page","example":"t3_post_2"},"next":{"type":["string","null"],"format":"uri","description":"URL for the next page, null on last page","example":"https://api.konbiniapi.com/v1/reddit/users/spez/posts?cursor=t3_post_2&count=25&order=top&time=week"},"itemCount":{"type":"integer","description":"Number of items returned in this page","example":30},"orderedItems":{"type":"array","items":{"$ref":"#/components/schemas/RedditPost"},"description":"Items in this page"}},"required":["@context","type","partOf","totalItems","cursor","nextCursor","next","itemCount","orderedItems"]}},"required":["data"]}}}},"400":{"description":"Bad Request — Invalid parameters","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["validation_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Validation error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"401":{"description":"Unauthorized — Missing or invalid API key","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["missing_api_key","invalid_api_key"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Invalid API key","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"402":{"description":"Payment Required — Credits exhausted","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["credits_exhausted"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Credits exhausted. Upgrade your plan at konbiniapi.com","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"403":{"description":"Forbidden — API key disabled or expired","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["api_key_disabled","api_key_expired"],"description":"Machine-readable error code"},"message":{"type":"string","example":"API key is disabled","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"404":{"description":"Not Found","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["not_found","route_not_found"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Not found","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"413":{"description":"Content Too Large — Request body exceeds 1 MB","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["validation_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Request body too large","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"500":{"description":"Internal Server Error","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["internal_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Internal error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"502":{"description":"Bad Gateway — Upstream platform error","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["platform_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Platform error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"503":{"description":"Service Unavailable","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["service_unavailable"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Service unavailable","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"504":{"description":"Gateway Timeout — Upstream platform timed out","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["platform_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Platform error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}}}}},"/v1/reddit/users/{username}/comments":{"get":{"operationId":"redditGetUserComments","tags":["Reddit"],"summary":"Get user comments","description":"Returns public comments made by a Reddit user. Supports hot, new, top, and controversial ordering, with optional time windows for top and controversial.","parameters":[{"schema":{"type":"string","description":"Reddit username (with or without `u/` prefix)","example":"spez"},"required":true,"description":"Reddit username (with or without `u/` prefix)","name":"username","in":"path"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":25,"description":"Number of comments to fetch (maximum: 100)","example":25},"required":false,"description":"Number of comments to fetch (maximum: 100)","name":"count","in":"query"},{"schema":{"type":"string","description":"Pagination cursor","example":"0"},"required":false,"description":"Pagination cursor","name":"cursor","in":"query"},{"schema":{"type":"string","enum":["hot","new","top","controversial"],"default":"new","description":"Sort order: new (default), hot, top, or controversial","example":"new"},"required":false,"description":"Sort order: new (default), hot, top, or controversial","name":"order","in":"query"},{"schema":{"type":"string","enum":["hour","day","week","month","year","all"],"description":"Time window for top or controversial ordering: hour, day, week, month, year, or all (default)","example":"week"},"required":false,"description":"Time window for top or controversial ordering: hour, day, week, month, year, or all (default)","name":"time","in":"query"}],"responses":{"200":{"description":"Returns the user comments","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"@context":{"type":"array","prefixItems":[{"type":"string","enum":["https://www.w3.org/ns/activitystreams#"]},{"type":"string","enum":["https://konbiniapi.com/ns/social#"]}],"description":"ActivityStreams JSON-LD context","example":["https://www.w3.org/ns/activitystreams#","https://konbiniapi.com/ns/social#"]},"type":{"type":"string","description":"ActivityStreams collection type","example":"OrderedCollectionPage"},"partOf":{"type":"string","format":"uri","description":"URL of the full collection","example":"https://api.konbiniapi.com/v1/reddit/users/spez/comments"},"totalItems":{"type":["integer","null"],"description":"Total number of items, null if unknown","example":1309},"cursor":{"type":["string","null"],"description":"Current page cursor, null on first page","example":null},"nextCursor":{"type":["string","null"],"description":"Cursor for the next page, null on last page","example":"t1_comment_2"},"next":{"type":["string","null"],"format":"uri","description":"URL for the next page, null on last page","example":"https://api.konbiniapi.com/v1/reddit/users/spez/comments?cursor=t1_comment_2&count=25&order=top&time=week"},"itemCount":{"type":"integer","description":"Number of items returned in this page","example":30},"orderedItems":{"type":"array","items":{"$ref":"#/components/schemas/RedditComment"},"description":"Items in this page"}},"required":["@context","type","partOf","totalItems","cursor","nextCursor","next","itemCount","orderedItems"]}},"required":["data"]}}}},"400":{"description":"Bad Request — Invalid parameters","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["validation_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Validation error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"401":{"description":"Unauthorized — Missing or invalid API key","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["missing_api_key","invalid_api_key"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Invalid API key","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"402":{"description":"Payment Required — Credits exhausted","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["credits_exhausted"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Credits exhausted. Upgrade your plan at konbiniapi.com","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"403":{"description":"Forbidden — API key disabled or expired","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["api_key_disabled","api_key_expired"],"description":"Machine-readable error code"},"message":{"type":"string","example":"API key is disabled","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"404":{"description":"Not Found","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["not_found","route_not_found"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Not found","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"413":{"description":"Content Too Large — Request body exceeds 1 MB","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["validation_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Request body too large","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"500":{"description":"Internal Server Error","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["internal_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Internal error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"502":{"description":"Bad Gateway — Upstream platform error","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["platform_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Platform error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"503":{"description":"Service Unavailable","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["service_unavailable"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Service unavailable","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"504":{"description":"Gateway Timeout — Upstream platform timed out","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["platform_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Platform error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}}}}},"/v1/reddit/users/{username}/overview":{"get":{"operationId":"redditGetUserOverview","tags":["Reddit"],"summary":"Get user overview","description":"Returns a mixed Reddit user activity feed including posts and comments. Supports hot, new, top, and controversial ordering, with optional time windows for top and controversial.","parameters":[{"schema":{"type":"string","description":"Reddit username (with or without `u/` prefix)","example":"spez"},"required":true,"description":"Reddit username (with or without `u/` prefix)","name":"username","in":"path"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":25,"description":"Number of activity items to fetch (maximum: 100)","example":25},"required":false,"description":"Number of activity items to fetch (maximum: 100)","name":"count","in":"query"},{"schema":{"type":"string","description":"Pagination cursor","example":"0"},"required":false,"description":"Pagination cursor","name":"cursor","in":"query"},{"schema":{"type":"string","enum":["hot","new","top","controversial"],"default":"new","description":"Sort order: new (default), hot, top, or controversial","example":"new"},"required":false,"description":"Sort order: new (default), hot, top, or controversial","name":"order","in":"query"},{"schema":{"type":"string","enum":["hour","day","week","month","year","all"],"description":"Time window for top or controversial ordering: hour, day, week, month, year, or all (default)","example":"week"},"required":false,"description":"Time window for top or controversial ordering: hour, day, week, month, year, or all (default)","name":"time","in":"query"}],"responses":{"200":{"description":"Returns the user overview activity feed","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"@context":{"type":"array","prefixItems":[{"type":"string","enum":["https://www.w3.org/ns/activitystreams#"]},{"type":"string","enum":["https://konbiniapi.com/ns/social#"]}],"description":"ActivityStreams JSON-LD context","example":["https://www.w3.org/ns/activitystreams#","https://konbiniapi.com/ns/social#"]},"type":{"type":"string","description":"ActivityStreams collection type","example":"OrderedCollectionPage"},"partOf":{"type":"string","format":"uri","description":"URL of the full collection","example":"https://api.konbiniapi.com/v1/reddit/users/spez/overview"},"totalItems":{"type":["integer","null"],"description":"Total number of items, null if unknown","example":1309},"cursor":{"type":["string","null"],"description":"Current page cursor, null on first page","example":null},"nextCursor":{"type":["string","null"],"description":"Cursor for the next page, null on last page","example":"t1_comment_1"},"next":{"type":["string","null"],"format":"uri","description":"URL for the next page, null on last page","example":"https://api.konbiniapi.com/v1/reddit/users/spez/overview?cursor=t1_comment_1&count=25&order=top&time=week"},"itemCount":{"type":"integer","description":"Number of items returned in this page","example":30},"orderedItems":{"type":"array","items":{"anyOf":[{"$ref":"#/components/schemas/RedditPost"},{"$ref":"#/components/schemas/RedditComment"}]},"description":"Items in this page"}},"required":["@context","type","partOf","totalItems","cursor","nextCursor","next","itemCount","orderedItems"]}},"required":["data"]}}}},"400":{"description":"Bad Request — Invalid parameters","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["validation_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Validation error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"401":{"description":"Unauthorized — Missing or invalid API key","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["missing_api_key","invalid_api_key"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Invalid API key","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"402":{"description":"Payment Required — Credits exhausted","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["credits_exhausted"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Credits exhausted. Upgrade your plan at konbiniapi.com","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"403":{"description":"Forbidden — API key disabled or expired","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["api_key_disabled","api_key_expired"],"description":"Machine-readable error code"},"message":{"type":"string","example":"API key is disabled","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"404":{"description":"Not Found","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["not_found","route_not_found"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Not found","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"413":{"description":"Content Too Large — Request body exceeds 1 MB","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["validation_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Request body too large","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"500":{"description":"Internal Server Error","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["internal_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Internal error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"502":{"description":"Bad Gateway — Upstream platform error","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["platform_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Platform error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"503":{"description":"Service Unavailable","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["service_unavailable"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Service unavailable","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"504":{"description":"Gateway Timeout — Upstream platform timed out","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["platform_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Platform error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}}}}},"/v1/reddit/subreddits/{subreddit}":{"get":{"operationId":"redditGetSubreddit","tags":["Reddit"],"summary":"Get subreddit","description":"Returns public subreddit metadata including title, description, icon, banner, and subscriber count.","parameters":[{"schema":{"type":"string","description":"Subreddit name (with or without `r/` prefix)","example":"programming"},"required":true,"description":"Subreddit name (with or without `r/` prefix)","name":"subreddit","in":"path"}],"responses":{"200":{"description":"Returns the subreddit details","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"@context":{"type":"array","prefixItems":[{"type":"string","enum":["https://www.w3.org/ns/activitystreams#"]},{"type":"string","enum":["https://konbiniapi.com/ns/social#"]}],"description":"ActivityStreams JSON-LD context","example":["https://www.w3.org/ns/activitystreams#","https://konbiniapi.com/ns/social#"]},"type":{"type":"string","enum":["Group"]},"id":{"type":"string","format":"uri","description":"Subreddit URL","example":"https://www.reddit.com/r/programming/"},"url":{"type":"string","format":"uri","description":"Subreddit URL","example":"https://www.reddit.com/r/programming/"},"entityId":{"type":"string","description":"Subreddit ID","example":"2fwo"},"slug":{"type":"string","description":"Subreddit slug without `r/`","example":"programming"},"name":{"type":"string","description":"Subreddit display title","example":"programming"},"summary":{"type":"string","description":"Short subreddit summary","example":"Subreddit dedicated to the news and discussions about the creation and use of technology and its surrounding issues."},"description":{"type":"string","description":"Long-form subreddit description","example":"/r/technology is a place to share and discuss the latest developments, happenings and curiosities in the world of technology."},"guidelines":{"type":"string","description":"Platform-provided community guidelines or posting guidance","example":"Please read the /r/technology sidebar for a list of our rules and guidelines."},"published":{"type":"string","format":"date-time","description":"Subreddit creation date","example":"2008-01-24T17:36:07.000Z"},"isAdult":{"type":"boolean","description":"Whether the subreddit is marked as adult content","example":false},"isSearchable":{"type":"boolean","description":"Whether the subreddit is discoverable in platform search and discovery surfaces","example":true},"category":{"type":"string","description":"Subreddit category","example":"Technology"},"memberCount":{"type":"integer","description":"Subscriber count","example":5000000},"icon":{"allOf":[{"$ref":"#/components/schemas/RedditImage"},{"description":"Community icon"}]},"image":{"allOf":[{"$ref":"#/components/schemas/RedditImage"},{"description":"Banner image"}]}},"required":["@context","type","id","url","name"]}},"required":["data"]}}}},"400":{"description":"Bad Request — Invalid parameters","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["validation_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Validation error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"401":{"description":"Unauthorized — Missing or invalid API key","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["missing_api_key","invalid_api_key"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Invalid API key","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"402":{"description":"Payment Required — Credits exhausted","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["credits_exhausted"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Credits exhausted. Upgrade your plan at konbiniapi.com","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"403":{"description":"Forbidden — API key disabled or expired","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["api_key_disabled","api_key_expired"],"description":"Machine-readable error code"},"message":{"type":"string","example":"API key is disabled","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"404":{"description":"Not Found","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["not_found","route_not_found","not_publicly_available"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Not found","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"413":{"description":"Content Too Large — Request body exceeds 1 MB","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["validation_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Request body too large","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"500":{"description":"Internal Server Error","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["internal_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Internal error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"502":{"description":"Bad Gateway — Upstream platform error","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["platform_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Platform error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"503":{"description":"Service Unavailable","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["service_unavailable"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Service unavailable","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"504":{"description":"Gateway Timeout — Upstream platform timed out","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["platform_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Platform error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}}}}},"/v1/reddit/subreddits/{subreddit}/posts":{"get":{"operationId":"redditGetSubredditPosts","tags":["Reddit"],"summary":"Get subreddit posts","description":"Returns public posts from a subreddit. Supports hot, new, top, rising, and controversial ordering, with optional time windows for top and controversial.","parameters":[{"schema":{"type":"string","description":"Subreddit name (with or without `r/` prefix)","example":"programming"},"required":true,"description":"Subreddit name (with or without `r/` prefix)","name":"subreddit","in":"path"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":25,"description":"Number of posts to fetch (maximum: 100)","example":25},"required":false,"description":"Number of posts to fetch (maximum: 100)","name":"count","in":"query"},{"schema":{"type":"string","description":"Pagination cursor","example":"0"},"required":false,"description":"Pagination cursor","name":"cursor","in":"query"},{"schema":{"type":"string","enum":["hot","new","top","rising","controversial"],"default":"hot","description":"Sort order: hot (default), new, top, rising, or controversial","example":"hot"},"required":false,"description":"Sort order: hot (default), new, top, rising, or controversial","name":"order","in":"query"},{"schema":{"type":"string","enum":["hour","day","week","month","year","all"],"description":"Time window for top or controversial ordering: hour, day, week, month, year, or all (default)","example":"week"},"required":false,"description":"Time window for top or controversial ordering: hour, day, week, month, year, or all (default)","name":"time","in":"query"}],"responses":{"200":{"description":"Returns the subreddit posts","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"@context":{"type":"array","prefixItems":[{"type":"string","enum":["https://www.w3.org/ns/activitystreams#"]},{"type":"string","enum":["https://konbiniapi.com/ns/social#"]}],"description":"ActivityStreams JSON-LD context","example":["https://www.w3.org/ns/activitystreams#","https://konbiniapi.com/ns/social#"]},"type":{"type":"string","description":"ActivityStreams collection type","example":"OrderedCollectionPage"},"partOf":{"type":"string","format":"uri","description":"URL of the full collection","example":"https://api.konbiniapi.com/v1/reddit/subreddits/programming/posts"},"totalItems":{"type":["integer","null"],"description":"Total number of items, null if unknown","example":1309},"cursor":{"type":["string","null"],"description":"Current page cursor, null on first page","example":null},"nextCursor":{"type":["string","null"],"description":"Cursor for the next page, null on last page","example":"t3_post_2"},"next":{"type":["string","null"],"format":"uri","description":"URL for the next page, null on last page","example":"https://api.konbiniapi.com/v1/reddit/subreddits/programming/posts?cursor=t3_post_2&count=25&order=top&time=month"},"itemCount":{"type":"integer","description":"Number of items returned in this page","example":30},"orderedItems":{"type":"array","items":{"$ref":"#/components/schemas/RedditPost"},"description":"Items in this page"}},"required":["@context","type","partOf","totalItems","cursor","nextCursor","next","itemCount","orderedItems"]}},"required":["data"]}}}},"400":{"description":"Bad Request — Invalid parameters","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["validation_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Validation error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"401":{"description":"Unauthorized — Missing or invalid API key","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["missing_api_key","invalid_api_key"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Invalid API key","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"402":{"description":"Payment Required — Credits exhausted","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["credits_exhausted"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Credits exhausted. Upgrade your plan at konbiniapi.com","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"403":{"description":"Forbidden — API key disabled or expired","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["api_key_disabled","api_key_expired"],"description":"Machine-readable error code"},"message":{"type":"string","example":"API key is disabled","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"404":{"description":"Not Found","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["not_found","route_not_found","not_publicly_available"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Not found","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"413":{"description":"Content Too Large — Request body exceeds 1 MB","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["validation_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Request body too large","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"500":{"description":"Internal Server Error","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["internal_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Internal error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"502":{"description":"Bad Gateway — Upstream platform error","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["platform_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Platform error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"503":{"description":"Service Unavailable","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["service_unavailable"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Service unavailable","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"504":{"description":"Gateway Timeout — Upstream platform timed out","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["platform_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Platform error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}}}}},"/v1/reddit/subreddits/{subreddit}/comments":{"get":{"operationId":"redditGetSubredditComments","tags":["Reddit"],"summary":"Get subreddit comments","description":"Returns public comments from a subreddit. Supports hot, new, top, and controversial ordering, with optional time windows for top and controversial.","parameters":[{"schema":{"type":"string","description":"Subreddit name (with or without `r/` prefix)","example":"programming"},"required":true,"description":"Subreddit name (with or without `r/` prefix)","name":"subreddit","in":"path"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":25,"description":"Number of comments to fetch (maximum: 100)","example":25},"required":false,"description":"Number of comments to fetch (maximum: 100)","name":"count","in":"query"},{"schema":{"type":"string","description":"Pagination cursor","example":"0"},"required":false,"description":"Pagination cursor","name":"cursor","in":"query"},{"schema":{"type":"string","enum":["hot","new","top","controversial"],"default":"hot","description":"Sort order: hot (default), new, top, or controversial","example":"hot"},"required":false,"description":"Sort order: hot (default), new, top, or controversial","name":"order","in":"query"},{"schema":{"type":"string","enum":["hour","day","week","month","year","all"],"description":"Time window for top or controversial ordering: hour, day, week, month, year, or all (default)","example":"week"},"required":false,"description":"Time window for top or controversial ordering: hour, day, week, month, year, or all (default)","name":"time","in":"query"}],"responses":{"200":{"description":"Returns the subreddit comments","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"@context":{"type":"array","prefixItems":[{"type":"string","enum":["https://www.w3.org/ns/activitystreams#"]},{"type":"string","enum":["https://konbiniapi.com/ns/social#"]}],"description":"ActivityStreams JSON-LD context","example":["https://www.w3.org/ns/activitystreams#","https://konbiniapi.com/ns/social#"]},"type":{"type":"string","description":"ActivityStreams collection type","example":"OrderedCollectionPage"},"partOf":{"type":"string","format":"uri","description":"URL of the full collection","example":"https://api.konbiniapi.com/v1/reddit/subreddits/programming/comments"},"totalItems":{"type":["integer","null"],"description":"Total number of items, null if unknown","example":1309},"cursor":{"type":["string","null"],"description":"Current page cursor, null on first page","example":null},"nextCursor":{"type":["string","null"],"description":"Cursor for the next page, null on last page","example":"t1_comment_2"},"next":{"type":["string","null"],"format":"uri","description":"URL for the next page, null on last page","example":"https://api.konbiniapi.com/v1/reddit/subreddits/programming/comments?cursor=t1_comment_2&count=25&order=top&time=week"},"itemCount":{"type":"integer","description":"Number of items returned in this page","example":30},"orderedItems":{"type":"array","items":{"$ref":"#/components/schemas/RedditComment"},"description":"Items in this page"}},"required":["@context","type","partOf","totalItems","cursor","nextCursor","next","itemCount","orderedItems"]}},"required":["data"]}}}},"400":{"description":"Bad Request — Invalid parameters","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["validation_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Validation error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"401":{"description":"Unauthorized — Missing or invalid API key","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["missing_api_key","invalid_api_key"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Invalid API key","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"402":{"description":"Payment Required — Credits exhausted","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["credits_exhausted"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Credits exhausted. Upgrade your plan at konbiniapi.com","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"403":{"description":"Forbidden — API key disabled or expired","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["api_key_disabled","api_key_expired"],"description":"Machine-readable error code"},"message":{"type":"string","example":"API key is disabled","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"404":{"description":"Not Found","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["not_found","route_not_found","not_publicly_available"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Not found","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"413":{"description":"Content Too Large — Request body exceeds 1 MB","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["validation_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Request body too large","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"500":{"description":"Internal Server Error","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["internal_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Internal error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"502":{"description":"Bad Gateway — Upstream platform error","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["platform_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Platform error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"503":{"description":"Service Unavailable","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["service_unavailable"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Service unavailable","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"504":{"description":"Gateway Timeout — Upstream platform timed out","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["platform_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Platform error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}}}}},"/v1/reddit/subreddits/{subreddit}/sticky":{"get":{"operationId":"redditGetSubredditSticky","tags":["Reddit"],"summary":"Get subreddit sticky posts","description":"Returns sticky posts for a subreddit across all available slots.","parameters":[{"schema":{"type":"string","description":"Subreddit name (with or without `r/` prefix)","example":"programming"},"required":true,"description":"Subreddit name (with or without `r/` prefix)","name":"subreddit","in":"path"}],"responses":{"200":{"description":"Returns subreddit sticky posts","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"@context":{"type":"array","prefixItems":[{"type":"string","enum":["https://www.w3.org/ns/activitystreams#"]},{"type":"string","enum":["https://konbiniapi.com/ns/social#"]}],"description":"ActivityStreams JSON-LD context","example":["https://www.w3.org/ns/activitystreams#","https://konbiniapi.com/ns/social#"]},"type":{"type":"string","enum":["OrderedCollection"]},"id":{"type":"string","format":"uri"},"url":{"type":"string","format":"uri"},"totalItems":{"type":"integer"},"orderedItems":{"type":"array","items":{"$ref":"#/components/schemas/RedditPost"}}},"required":["@context","type","id","url","totalItems","orderedItems"]}},"required":["data"]}}}},"400":{"description":"Bad Request — Invalid parameters","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["validation_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Validation error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"401":{"description":"Unauthorized — Missing or invalid API key","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["missing_api_key","invalid_api_key"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Invalid API key","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"402":{"description":"Payment Required — Credits exhausted","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["credits_exhausted"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Credits exhausted. Upgrade your plan at konbiniapi.com","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"403":{"description":"Forbidden — API key disabled or expired","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["api_key_disabled","api_key_expired"],"description":"Machine-readable error code"},"message":{"type":"string","example":"API key is disabled","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"404":{"description":"Not Found","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["not_found","route_not_found","not_publicly_available"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Not found","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"413":{"description":"Content Too Large — Request body exceeds 1 MB","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["validation_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Request body too large","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"500":{"description":"Internal Server Error","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["internal_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Internal error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"502":{"description":"Bad Gateway — Upstream platform error","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["platform_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Platform error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"503":{"description":"Service Unavailable","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["service_unavailable"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Service unavailable","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"504":{"description":"Gateway Timeout — Upstream platform timed out","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["platform_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Platform error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}}}}},"/v1/reddit/subreddits/{subreddit}/rules":{"get":{"operationId":"redditGetSubredditRules","tags":["Reddit"],"summary":"Get subreddit rules","description":"Returns structured community rules for a subreddit.","parameters":[{"schema":{"type":"string","description":"Subreddit name (with or without `r/` prefix)","example":"programming"},"required":true,"description":"Subreddit name (with or without `r/` prefix)","name":"subreddit","in":"path"}],"responses":{"200":{"description":"Returns subreddit rules","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"@context":{"type":"array","prefixItems":[{"type":"string","enum":["https://www.w3.org/ns/activitystreams#"]},{"type":"string","enum":["https://konbiniapi.com/ns/social#"]}],"description":"ActivityStreams JSON-LD context","example":["https://www.w3.org/ns/activitystreams#","https://konbiniapi.com/ns/social#"]},"type":{"type":"string","enum":["OrderedCollection"]},"id":{"type":"string","format":"uri"},"url":{"type":"string","format":"uri"},"totalItems":{"type":"integer"},"orderedItems":{"type":"array","items":{"$ref":"#/components/schemas/RedditRule"}}},"required":["@context","type","id","url","totalItems","orderedItems"]}},"required":["data"]}}}},"400":{"description":"Bad Request — Invalid parameters","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["validation_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Validation error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"401":{"description":"Unauthorized — Missing or invalid API key","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["missing_api_key","invalid_api_key"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Invalid API key","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"402":{"description":"Payment Required — Credits exhausted","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["credits_exhausted"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Credits exhausted. Upgrade your plan at konbiniapi.com","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"403":{"description":"Forbidden — API key disabled or expired","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["api_key_disabled","api_key_expired"],"description":"Machine-readable error code"},"message":{"type":"string","example":"API key is disabled","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"404":{"description":"Not Found","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["not_found","route_not_found","not_publicly_available"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Not found","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"413":{"description":"Content Too Large — Request body exceeds 1 MB","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["validation_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Request body too large","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"500":{"description":"Internal Server Error","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["internal_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Internal error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"502":{"description":"Bad Gateway — Upstream platform error","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["platform_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Platform error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"503":{"description":"Service Unavailable","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["service_unavailable"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Service unavailable","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"504":{"description":"Gateway Timeout — Upstream platform timed out","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["platform_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Platform error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}}}}},"/v1/reddit/subreddits/{subreddit}/search":{"get":{"operationId":"redditSearchSubredditPosts","tags":["Reddit"],"summary":"Search subreddit posts","description":"Searches public Reddit posts within a subreddit. Supports relevance, hot, top, new, and comments sorting with optional time windows.","parameters":[{"schema":{"type":"string","description":"Subreddit name (with or without `r/` prefix)","example":"programming"},"required":true,"description":"Subreddit name (with or without `r/` prefix)","name":"subreddit","in":"path"},{"schema":{"type":"string","minLength":1,"description":"Search query","example":"askreddit"},"required":true,"description":"Search query","name":"q","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":25,"description":"Number of posts to fetch (maximum: 100)","example":25},"required":false,"description":"Number of posts to fetch (maximum: 100)","name":"count","in":"query"},{"schema":{"type":"string","description":"Pagination cursor","example":"0"},"required":false,"description":"Pagination cursor","name":"cursor","in":"query"},{"schema":{"type":"string","enum":["relevance","hot","top","new","comments"],"default":"relevance","description":"Sort order: relevance (default), hot, top, new, or comments","example":"relevance"},"required":false,"description":"Sort order: relevance (default), hot, top, new, or comments","name":"order","in":"query"},{"schema":{"type":"string","enum":["hour","day","week","month","year","all"],"description":"Optional time window for search results: hour, day, week, month, year, or all","example":"week"},"required":false,"description":"Optional time window for search results: hour, day, week, month, year, or all","name":"time","in":"query"}],"responses":{"200":{"description":"Returns subreddit search results","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"@context":{"type":"array","prefixItems":[{"type":"string","enum":["https://www.w3.org/ns/activitystreams#"]},{"type":"string","enum":["https://konbiniapi.com/ns/social#"]}],"description":"ActivityStreams JSON-LD context","example":["https://www.w3.org/ns/activitystreams#","https://konbiniapi.com/ns/social#"]},"type":{"type":"string","description":"ActivityStreams collection type","example":"OrderedCollectionPage"},"partOf":{"type":"string","format":"uri","description":"URL of the full collection","example":"https://api.konbiniapi.com/v1/reddit/subreddits/programming/search?q=openai"},"totalItems":{"type":["integer","null"],"description":"Total number of items, null if unknown","example":1309},"cursor":{"type":["string","null"],"description":"Current page cursor, null on first page","example":null},"nextCursor":{"type":["string","null"],"description":"Cursor for the next page, null on last page","example":"t3_post_2"},"next":{"type":["string","null"],"format":"uri","description":"URL for the next page, null on last page","example":"https://api.konbiniapi.com/v1/reddit/subreddits/programming/search?q=openai&cursor=t3_post_2&count=25&order=top&time=week"},"itemCount":{"type":"integer","description":"Number of items returned in this page","example":30},"orderedItems":{"type":"array","items":{"$ref":"#/components/schemas/RedditPost"},"description":"Items in this page"}},"required":["@context","type","partOf","totalItems","cursor","nextCursor","next","itemCount","orderedItems"]}},"required":["data"]}}}},"400":{"description":"Bad Request — Invalid parameters","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["validation_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Validation error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"401":{"description":"Unauthorized — Missing or invalid API key","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["missing_api_key","invalid_api_key"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Invalid API key","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"402":{"description":"Payment Required — Credits exhausted","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["credits_exhausted"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Credits exhausted. Upgrade your plan at konbiniapi.com","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"403":{"description":"Forbidden — API key disabled or expired","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["api_key_disabled","api_key_expired"],"description":"Machine-readable error code"},"message":{"type":"string","example":"API key is disabled","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"404":{"description":"Not Found","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["not_found","route_not_found","not_publicly_available"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Not found","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"413":{"description":"Content Too Large — Request body exceeds 1 MB","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["validation_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Request body too large","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"500":{"description":"Internal Server Error","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["internal_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Internal error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"502":{"description":"Bad Gateway — Upstream platform error","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["platform_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Platform error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"503":{"description":"Service Unavailable","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["service_unavailable"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Service unavailable","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"504":{"description":"Gateway Timeout — Upstream platform timed out","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["platform_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Platform error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}}}}},"/v1/reddit/subreddits/batch":{"post":{"operationId":"redditGetSubredditsBatch","tags":["Reddit"],"summary":"Get subreddits in batch","description":"Returns up to 100 Reddit subreddits by ID in a single request. Costs 1 credit per ID submitted.","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"entityIds":{"type":"array","items":{"type":"string","pattern":"^(t5_)?[a-zA-Z0-9]+$"},"minItems":1,"maxItems":100,"example":["2qh3l","2qh0u"]}},"required":["entityIds"]}}}},"responses":{"200":{"description":"Returns the found Reddit subreddits","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"@context":{"type":"array","prefixItems":[{"type":"string","enum":["https://www.w3.org/ns/activitystreams#"]},{"type":"string","enum":["https://konbiniapi.com/ns/social#"]}],"description":"ActivityStreams JSON-LD context","example":["https://www.w3.org/ns/activitystreams#","https://konbiniapi.com/ns/social#"]},"type":{"type":"string","enum":["Collection"],"example":"Collection"},"itemCount":{"type":"integer","description":"Number of items returned","example":10},"items":{"type":"array","items":{"$ref":"#/components/schemas/RedditSubreddit"},"description":"Requested items that were found"}},"required":["@context","type","itemCount","items"]}},"required":["data"]}}}},"400":{"description":"Bad Request — Invalid parameters","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["validation_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Validation error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"401":{"description":"Unauthorized — Missing or invalid API key","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["missing_api_key","invalid_api_key"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Invalid API key","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"402":{"description":"Payment Required — Credits exhausted","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["credits_exhausted"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Credits exhausted. Upgrade your plan at konbiniapi.com","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"403":{"description":"Forbidden — API key disabled or expired","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["api_key_disabled","api_key_expired"],"description":"Machine-readable error code"},"message":{"type":"string","example":"API key is disabled","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"404":{"description":"Not Found","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["not_found","route_not_found"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Not found","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"413":{"description":"Content Too Large — Request body exceeds 1 MB","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["validation_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Request body too large","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"500":{"description":"Internal Server Error","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["internal_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Internal error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"502":{"description":"Bad Gateway — Upstream platform error","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["platform_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Platform error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"503":{"description":"Service Unavailable","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["service_unavailable"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Service unavailable","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"504":{"description":"Gateway Timeout — Upstream platform timed out","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["platform_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Platform error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}}}}},"/v1/reddit/posts/{postId}":{"get":{"operationId":"redditGetPost","tags":["Reddit"],"summary":"Get post","description":"Returns a public Reddit post with title, body, author info, engagement counts, and attachments.","parameters":[{"schema":{"type":"string","description":"Reddit post ID (e.g. `1tlh5aj` or `t3_1tlh5aj`)","example":"1tlh5aj"},"required":true,"description":"Reddit post ID (e.g. `1tlh5aj` or `t3_1tlh5aj`)","name":"postId","in":"path"}],"responses":{"200":{"description":"Returns the Reddit post","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"@context":{"type":"array","prefixItems":[{"type":"string","enum":["https://www.w3.org/ns/activitystreams#"]},{"type":"string","enum":["https://konbiniapi.com/ns/social#"]}],"description":"ActivityStreams JSON-LD context","example":["https://www.w3.org/ns/activitystreams#","https://konbiniapi.com/ns/social#"]},"type":{"type":"string","enum":["Note"]},"id":{"type":"string","format":"uri","description":"Post permalink","example":"https://www.reddit.com/r/programming/comments/post_1/launch_day/"},"url":{"type":"string","format":"uri","description":"Post permalink","example":"https://www.reddit.com/r/programming/comments/post_1/launch_day/"},"entityId":{"type":"string","description":"Reddit post ID","example":"post_1"},"name":{"type":"string","description":"Post title","example":"Launch day"},"content":{"type":["string","null"],"description":"Post body text","example":"We shipped Reddit support."},"published":{"type":"string","format":"date-time","description":"Publication date in ISO 8601 format","example":"2026-02-27T20:37:38.000Z"},"isEdited":{"type":"boolean","description":"Whether the post has been edited","example":false},"isLocked":{"type":"boolean","description":"Whether the post is locked","example":false},"isOriginal":{"type":"boolean","description":"Whether the post is marked as original content","example":false},"isPinned":{"type":"boolean","description":"Whether the post is stickied","example":false},"isSponsored":{"type":"boolean","description":"Whether the post is promoted","example":false},"isAdult":{"type":"boolean","description":"Whether the post is marked as adult content","example":false},"isSpoiler":{"type":"boolean","description":"Whether the post is marked as a spoiler","example":false},"isSearchable":{"type":"boolean","description":"Whether the post is visible to search engines","example":true},"likeCount":{"type":"integer","description":"Number of likes","example":93210},"voteCount":{"type":"integer","description":"Net score","example":118},"commentCount":{"type":"integer","description":"Comment count","example":15},"shareCount":{"type":"integer","description":"Number of crossposts","example":8},"attributedTo":{"$ref":"#/components/schemas/RedditEmbeddedUser"},"icon":{"allOf":[{"$ref":"#/components/schemas/RedditImage"},{"description":"Thumbnail image"}]},"image":{"type":"array","items":{"allOf":[{"$ref":"#/components/schemas/RedditImage"},{"description":"Reddit image resource"}]},"description":"Preview image variants"},"attachment":{"type":"array","items":{"anyOf":[{"allOf":[{"$ref":"#/components/schemas/RedditImage"},{"description":"Reddit image resource"}]},{"$ref":"#/components/schemas/RedditVideoAttachment"},{"$ref":"#/components/schemas/RedditLinkAttachment"}]},"description":"Post attachments"},"tag":{"type":"array","items":{"$ref":"#/components/schemas/RedditTag"},"description":"Subreddit and flair tags"},"quote":{"$ref":"#/components/schemas/RedditQuotedPost"}},"required":["@context","type","id","url","content","likeCount"]}},"required":["data"]}}}},"400":{"description":"Bad Request — Invalid parameters","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["validation_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Validation error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"401":{"description":"Unauthorized — Missing or invalid API key","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["missing_api_key","invalid_api_key"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Invalid API key","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"402":{"description":"Payment Required — Credits exhausted","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["credits_exhausted"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Credits exhausted. Upgrade your plan at konbiniapi.com","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"403":{"description":"Forbidden — API key disabled or expired","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["api_key_disabled","api_key_expired"],"description":"Machine-readable error code"},"message":{"type":"string","example":"API key is disabled","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"404":{"description":"Not Found","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["not_found","route_not_found"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Not found","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"413":{"description":"Content Too Large — Request body exceeds 1 MB","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["validation_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Request body too large","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"500":{"description":"Internal Server Error","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["internal_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Internal error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"502":{"description":"Bad Gateway — Upstream platform error","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["platform_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Platform error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"503":{"description":"Service Unavailable","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["service_unavailable"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Service unavailable","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"504":{"description":"Gateway Timeout — Upstream platform timed out","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["platform_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Platform error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}}}}},"/v1/reddit/posts/{postId}/duplicates":{"get":{"operationId":"redditGetPostDuplicates","tags":["Reddit"],"summary":"Get duplicate posts","description":"Returns duplicate submissions and crossposts associated with a Reddit post.","parameters":[{"schema":{"type":"string","description":"Reddit post ID (e.g. `1tlh5aj` or `t3_1tlh5aj`)","example":"1tlh5aj"},"required":true,"description":"Reddit post ID (e.g. `1tlh5aj` or `t3_1tlh5aj`)","name":"postId","in":"path"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":25,"description":"Number of posts to fetch (maximum: 100)","example":25},"required":false,"description":"Number of posts to fetch (maximum: 100)","name":"count","in":"query"},{"schema":{"type":"string","description":"Pagination cursor","example":"0"},"required":false,"description":"Pagination cursor","name":"cursor","in":"query"}],"responses":{"200":{"description":"Returns duplicate posts","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"@context":{"type":"array","prefixItems":[{"type":"string","enum":["https://www.w3.org/ns/activitystreams#"]},{"type":"string","enum":["https://konbiniapi.com/ns/social#"]}],"description":"ActivityStreams JSON-LD context","example":["https://www.w3.org/ns/activitystreams#","https://konbiniapi.com/ns/social#"]},"type":{"type":"string","description":"ActivityStreams collection type","example":"OrderedCollectionPage"},"partOf":{"type":"string","format":"uri","description":"URL of the full collection","example":"https://api.konbiniapi.com/v1/reddit/posts/1t0r5t5/duplicates"},"totalItems":{"type":["integer","null"],"description":"Total number of items, null if unknown","example":1309},"cursor":{"type":["string","null"],"description":"Current page cursor, null on first page","example":null},"nextCursor":{"type":["string","null"],"description":"Cursor for the next page, null on last page","example":"t3_post_2"},"next":{"type":["string","null"],"format":"uri","description":"URL for the next page, null on last page","example":"https://api.konbiniapi.com/v1/reddit/posts/1t0r5t5/duplicates?cursor=t3_post_2&count=25"},"itemCount":{"type":"integer","description":"Number of items returned in this page","example":30},"orderedItems":{"type":"array","items":{"$ref":"#/components/schemas/RedditPost"},"description":"Items in this page"}},"required":["@context","type","partOf","totalItems","cursor","nextCursor","next","itemCount","orderedItems"]}},"required":["data"]}}}},"400":{"description":"Bad Request — Invalid parameters","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["validation_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Validation error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"401":{"description":"Unauthorized — Missing or invalid API key","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["missing_api_key","invalid_api_key"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Invalid API key","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"402":{"description":"Payment Required — Credits exhausted","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["credits_exhausted"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Credits exhausted. Upgrade your plan at konbiniapi.com","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"403":{"description":"Forbidden — API key disabled or expired","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["api_key_disabled","api_key_expired"],"description":"Machine-readable error code"},"message":{"type":"string","example":"API key is disabled","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"404":{"description":"Not Found","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["not_found","route_not_found"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Not found","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"413":{"description":"Content Too Large — Request body exceeds 1 MB","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["validation_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Request body too large","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"500":{"description":"Internal Server Error","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["internal_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Internal error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"502":{"description":"Bad Gateway — Upstream platform error","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["platform_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Platform error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"503":{"description":"Service Unavailable","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["service_unavailable"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Service unavailable","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"504":{"description":"Gateway Timeout — Upstream platform timed out","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["platform_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Platform error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}}}}},"/v1/reddit/posts/{postId}/comments":{"get":{"operationId":"redditGetPostComments","tags":["Reddit"],"summary":"Get post comments","description":"Returns top-level comments on a Reddit post. Supports Reddit comment ordering and cursor-based pagination.","parameters":[{"schema":{"type":"string","description":"Reddit post ID (e.g. `1tlh5aj` or `t3_1tlh5aj`)","example":"1tlh5aj"},"required":true,"description":"Reddit post ID (e.g. `1tlh5aj` or `t3_1tlh5aj`)","name":"postId","in":"path"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":25,"description":"Number of comments to fetch (maximum: 100)","example":25},"required":false,"description":"Number of comments to fetch (maximum: 100)","name":"count","in":"query"},{"schema":{"type":"string","description":"Pagination cursor","example":"0"},"required":false,"description":"Pagination cursor","name":"cursor","in":"query"},{"schema":{"type":"string","enum":["best","top","new","controversial","old"],"default":"best","description":"Sort order: best (default), top, new, controversial, or old","example":"best"},"required":false,"description":"Sort order: best (default), top, new, controversial, or old","name":"order","in":"query"}],"responses":{"200":{"description":"Returns the post comments","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"@context":{"type":"array","prefixItems":[{"type":"string","enum":["https://www.w3.org/ns/activitystreams#"]},{"type":"string","enum":["https://konbiniapi.com/ns/social#"]}],"description":"ActivityStreams JSON-LD context","example":["https://www.w3.org/ns/activitystreams#","https://konbiniapi.com/ns/social#"]},"type":{"type":"string","description":"ActivityStreams collection type","example":"OrderedCollectionPage"},"partOf":{"type":"string","format":"uri","description":"URL of the full collection","example":"https://api.konbiniapi.com/v1/reddit/posts/post_1/comments"},"totalItems":{"type":["integer","null"],"description":"Total number of items, null if unknown","example":1309},"cursor":{"type":["string","null"],"description":"Current page cursor, null on first page","example":null},"nextCursor":{"type":["string","null"],"description":"Cursor for the next page, null on last page","example":"t1_comment_3"},"next":{"type":["string","null"],"format":"uri","description":"URL for the next page, null on last page","example":"https://api.konbiniapi.com/v1/reddit/posts/post_1/comments?cursor=t1_comment_3&count=25&order=top"},"itemCount":{"type":"integer","description":"Number of items returned in this page","example":30},"orderedItems":{"type":"array","items":{"$ref":"#/components/schemas/RedditComment"},"description":"Items in this page"}},"required":["@context","type","partOf","totalItems","cursor","nextCursor","next","itemCount","orderedItems"]}},"required":["data"]}}}},"400":{"description":"Bad Request — Invalid parameters","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["validation_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Validation error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"401":{"description":"Unauthorized — Missing or invalid API key","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["missing_api_key","invalid_api_key"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Invalid API key","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"402":{"description":"Payment Required — Credits exhausted","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["credits_exhausted"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Credits exhausted. Upgrade your plan at konbiniapi.com","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"403":{"description":"Forbidden — API key disabled or expired","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["api_key_disabled","api_key_expired"],"description":"Machine-readable error code"},"message":{"type":"string","example":"API key is disabled","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"404":{"description":"Not Found","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["not_found","route_not_found"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Not found","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"413":{"description":"Content Too Large — Request body exceeds 1 MB","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["validation_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Request body too large","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"500":{"description":"Internal Server Error","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["internal_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Internal error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"502":{"description":"Bad Gateway — Upstream platform error","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["platform_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Platform error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"503":{"description":"Service Unavailable","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["service_unavailable"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Service unavailable","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"504":{"description":"Gateway Timeout — Upstream platform timed out","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["platform_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Platform error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}}}}},"/v1/reddit/posts/{postId}/comments/{commentId}":{"get":{"operationId":"redditGetComment","tags":["Reddit"],"summary":"Get comment","description":"Returns a public Reddit comment with author info, scores, reply presence, and media when available.","parameters":[{"schema":{"type":"string","description":"Reddit post ID (e.g. `1tlh5aj` or `t3_1tlh5aj`)","example":"1tlh5aj"},"required":true,"description":"Reddit post ID (e.g. `1tlh5aj` or `t3_1tlh5aj`)","name":"postId","in":"path"},{"schema":{"type":"string","description":"Reddit comment ID (e.g. `onflihe` or `t1_onflihe`)","example":"onflihe"},"required":true,"description":"Reddit comment ID (e.g. `onflihe` or `t1_onflihe`)","name":"commentId","in":"path"}],"responses":{"200":{"description":"Returns the Reddit comment","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"@context":{"type":"array","prefixItems":[{"type":"string","enum":["https://www.w3.org/ns/activitystreams#"]},{"type":"string","enum":["https://konbiniapi.com/ns/social#"]}],"description":"ActivityStreams JSON-LD context","example":["https://www.w3.org/ns/activitystreams#","https://konbiniapi.com/ns/social#"]},"type":{"type":"string","enum":["Note"]},"id":{"type":"string","format":"uri","description":"Comment permalink","example":"https://www.reddit.com/r/programming/comments/post_1/launch_day/comment_1/"},"url":{"type":"string","format":"uri","description":"Comment permalink","example":"https://www.reddit.com/r/programming/comments/post_1/launch_day/comment_1/"},"entityId":{"type":"string","description":"Reddit comment ID","example":"comment_1"},"content":{"type":"string","description":"Comment text","example":"First!"},"published":{"type":"string","format":"date-time","description":"Publication date in ISO 8601 format","example":"2026-02-27T20:37:38.000Z"},"isPinned":{"type":"boolean","description":"Whether the comment is stickied","example":false},"isSponsored":{"type":"boolean","description":"Whether the comment is promoted","example":false},"hasReplies":{"type":"boolean","description":"Whether the comment has a replies listing available","example":true},"likeCount":{"type":"integer","description":"Number of likes","example":93210},"voteCount":{"type":"integer","description":"Net score","example":9},"attributedTo":{"allOf":[{"$ref":"#/components/schemas/RedditEmbeddedUser"},{"description":"Comment author"}]},"inReplyTo":{"type":"string","format":"uri","description":"Parent post or comment URL","example":"https://www.reddit.com/r/programming/comments/post_1/launch_day/"},"image":{"allOf":[{"$ref":"#/components/schemas/RedditImage"},{"description":"Primary comment image"}]},"attachment":{"type":"array","items":{"allOf":[{"$ref":"#/components/schemas/RedditImage"},{"description":"Reddit image resource"}]},"description":"Comment attachments"}},"required":["@context","type","id","content","likeCount"]}},"required":["data"]}}}},"400":{"description":"Bad Request — Invalid parameters","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["validation_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Validation error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"401":{"description":"Unauthorized — Missing or invalid API key","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["missing_api_key","invalid_api_key"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Invalid API key","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"402":{"description":"Payment Required — Credits exhausted","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["credits_exhausted"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Credits exhausted. Upgrade your plan at konbiniapi.com","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"403":{"description":"Forbidden — API key disabled or expired","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["api_key_disabled","api_key_expired"],"description":"Machine-readable error code"},"message":{"type":"string","example":"API key is disabled","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"404":{"description":"Not Found","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["not_found","route_not_found"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Not found","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"413":{"description":"Content Too Large — Request body exceeds 1 MB","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["validation_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Request body too large","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"500":{"description":"Internal Server Error","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["internal_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Internal error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"502":{"description":"Bad Gateway — Upstream platform error","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["platform_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Platform error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"503":{"description":"Service Unavailable","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["service_unavailable"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Service unavailable","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"504":{"description":"Gateway Timeout — Upstream platform timed out","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["platform_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Platform error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}}}}},"/v1/reddit/posts/{postId}/comments/{commentId}/replies":{"get":{"operationId":"redditGetCommentReplies","tags":["Reddit"],"summary":"Get comment replies","description":"Returns direct replies to a Reddit comment using cursor-based pagination.","parameters":[{"schema":{"type":"string","description":"Reddit post ID (e.g. `1tlh5aj` or `t3_1tlh5aj`)","example":"1tlh5aj"},"required":true,"description":"Reddit post ID (e.g. `1tlh5aj` or `t3_1tlh5aj`)","name":"postId","in":"path"},{"schema":{"type":"string","description":"Reddit comment ID (e.g. `onflihe` or `t1_onflihe`)","example":"onflihe"},"required":true,"description":"Reddit comment ID (e.g. `onflihe` or `t1_onflihe`)","name":"commentId","in":"path"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":20,"description":"Number of replies to fetch (maximum: 100)","example":20},"required":false,"description":"Number of replies to fetch (maximum: 100)","name":"count","in":"query"},{"schema":{"type":"string","description":"Pagination cursor","example":"0"},"required":false,"description":"Pagination cursor","name":"cursor","in":"query"}],"responses":{"200":{"description":"Returns the comment replies","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"@context":{"type":"array","prefixItems":[{"type":"string","enum":["https://www.w3.org/ns/activitystreams#"]},{"type":"string","enum":["https://konbiniapi.com/ns/social#"]}],"description":"ActivityStreams JSON-LD context","example":["https://www.w3.org/ns/activitystreams#","https://konbiniapi.com/ns/social#"]},"type":{"type":"string","description":"ActivityStreams collection type","example":"OrderedCollectionPage"},"partOf":{"type":"string","format":"uri","description":"URL of the full collection","example":"https://api.konbiniapi.com/v1/reddit/posts/post_1/comments/comment_1/replies"},"totalItems":{"type":["integer","null"],"description":"Total number of items, null if unknown","example":1309},"cursor":{"type":["string","null"],"description":"Current page cursor, null on first page","example":null},"nextCursor":{"type":["string","null"],"description":"Cursor for the next page, null on last page","example":"WyJyZXBseV8yIl0"},"next":{"type":["string","null"],"format":"uri","description":"URL for the next page, null on last page","example":"https://api.konbiniapi.com/v1/reddit/posts/post_1/comments/comment_1/replies?cursor=WyJyZXBseV8yIl0&count=20"},"itemCount":{"type":"integer","description":"Number of items returned in this page","example":30},"orderedItems":{"type":"array","items":{"$ref":"#/components/schemas/RedditComment"},"description":"Items in this page"}},"required":["@context","type","partOf","totalItems","cursor","nextCursor","next","itemCount","orderedItems"]}},"required":["data"]}}}},"400":{"description":"Bad Request — Invalid parameters","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["validation_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Validation error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"401":{"description":"Unauthorized — Missing or invalid API key","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["missing_api_key","invalid_api_key"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Invalid API key","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"402":{"description":"Payment Required — Credits exhausted","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["credits_exhausted"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Credits exhausted. Upgrade your plan at konbiniapi.com","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"403":{"description":"Forbidden — API key disabled or expired","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["api_key_disabled","api_key_expired"],"description":"Machine-readable error code"},"message":{"type":"string","example":"API key is disabled","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"404":{"description":"Not Found","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["not_found","route_not_found"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Not found","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"413":{"description":"Content Too Large — Request body exceeds 1 MB","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["validation_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Request body too large","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"500":{"description":"Internal Server Error","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["internal_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Internal error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"502":{"description":"Bad Gateway — Upstream platform error","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["platform_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Platform error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"503":{"description":"Service Unavailable","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["service_unavailable"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Service unavailable","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"504":{"description":"Gateway Timeout — Upstream platform timed out","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["platform_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Platform error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}}}}},"/v1/reddit/posts/batch":{"post":{"operationId":"redditGetPostsBatch","tags":["Reddit"],"summary":"Get posts in batch","description":"Returns up to 100 Reddit posts by ID in a single request. Costs 1 credit per ID submitted.","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"entityIds":{"type":"array","items":{"type":"string","pattern":"^(t3_)?[a-zA-Z0-9]+$"},"minItems":1,"maxItems":100,"example":["1tlh5aj","1t4mguu","1t6ddw2"]}},"required":["entityIds"]}}}},"responses":{"200":{"description":"Returns the found Reddit posts","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"@context":{"type":"array","prefixItems":[{"type":"string","enum":["https://www.w3.org/ns/activitystreams#"]},{"type":"string","enum":["https://konbiniapi.com/ns/social#"]}],"description":"ActivityStreams JSON-LD context","example":["https://www.w3.org/ns/activitystreams#","https://konbiniapi.com/ns/social#"]},"type":{"type":"string","enum":["Collection"],"example":"Collection"},"itemCount":{"type":"integer","description":"Number of items returned","example":10},"items":{"type":"array","items":{"$ref":"#/components/schemas/RedditPost"},"description":"Requested items that were found"}},"required":["@context","type","itemCount","items"]}},"required":["data"]}}}},"400":{"description":"Bad Request — Invalid parameters","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["validation_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Validation error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"401":{"description":"Unauthorized — Missing or invalid API key","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["missing_api_key","invalid_api_key"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Invalid API key","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"402":{"description":"Payment Required — Credits exhausted","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["credits_exhausted"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Credits exhausted. Upgrade your plan at konbiniapi.com","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"403":{"description":"Forbidden — API key disabled or expired","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["api_key_disabled","api_key_expired"],"description":"Machine-readable error code"},"message":{"type":"string","example":"API key is disabled","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"404":{"description":"Not Found","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["not_found","route_not_found"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Not found","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"413":{"description":"Content Too Large — Request body exceeds 1 MB","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["validation_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Request body too large","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"500":{"description":"Internal Server Error","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["internal_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Internal error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"502":{"description":"Bad Gateway — Upstream platform error","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["platform_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Platform error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"503":{"description":"Service Unavailable","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["service_unavailable"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Service unavailable","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"504":{"description":"Gateway Timeout — Upstream platform timed out","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["platform_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Platform error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}}}}},"/v1/reddit/comments/batch":{"post":{"operationId":"redditGetCommentsBatch","tags":["Reddit"],"summary":"Get comments in batch","description":"Returns up to 100 Reddit comments by ID in a single request. Costs 1 credit per ID submitted.","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"entityIds":{"type":"array","items":{"type":"string","pattern":"^(t1_)?[a-zA-Z0-9]+$"},"minItems":1,"maxItems":100,"example":["okpklb6","ojb40kw"]}},"required":["entityIds"]}}}},"responses":{"200":{"description":"Returns the found Reddit comments","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"@context":{"type":"array","prefixItems":[{"type":"string","enum":["https://www.w3.org/ns/activitystreams#"]},{"type":"string","enum":["https://konbiniapi.com/ns/social#"]}],"description":"ActivityStreams JSON-LD context","example":["https://www.w3.org/ns/activitystreams#","https://konbiniapi.com/ns/social#"]},"type":{"type":"string","enum":["Collection"],"example":"Collection"},"itemCount":{"type":"integer","description":"Number of items returned","example":10},"items":{"type":"array","items":{"$ref":"#/components/schemas/RedditComment"},"description":"Requested items that were found"}},"required":["@context","type","itemCount","items"]}},"required":["data"]}}}},"400":{"description":"Bad Request — Invalid parameters","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["validation_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Validation error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"401":{"description":"Unauthorized — Missing or invalid API key","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["missing_api_key","invalid_api_key"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Invalid API key","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"402":{"description":"Payment Required — Credits exhausted","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["credits_exhausted"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Credits exhausted. Upgrade your plan at konbiniapi.com","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"403":{"description":"Forbidden — API key disabled or expired","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["api_key_disabled","api_key_expired"],"description":"Machine-readable error code"},"message":{"type":"string","example":"API key is disabled","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"404":{"description":"Not Found","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["not_found","route_not_found"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Not found","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"413":{"description":"Content Too Large — Request body exceeds 1 MB","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["validation_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Request body too large","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"500":{"description":"Internal Server Error","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["internal_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Internal error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"502":{"description":"Bad Gateway — Upstream platform error","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["platform_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Platform error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"503":{"description":"Service Unavailable","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["service_unavailable"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Service unavailable","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"504":{"description":"Gateway Timeout — Upstream platform timed out","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["platform_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Platform error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}}}}},"/v1/reddit/feeds/{feed}":{"get":{"operationId":"redditGetFeed","tags":["Reddit"],"summary":"Get feed","description":"Returns posts from a top-level Reddit feed such as best, hot, new, top, rising, or controversial.","parameters":[{"schema":{"type":"string","enum":["best","hot","new","top","rising","controversial"],"description":"Reddit feed kind","example":"best"},"required":true,"description":"Reddit feed kind","name":"feed","in":"path"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":25,"description":"Number of posts to fetch (maximum: 100)","example":25},"required":false,"description":"Number of posts to fetch (maximum: 100)","name":"count","in":"query"},{"schema":{"type":"string","description":"Pagination cursor","example":"0"},"required":false,"description":"Pagination cursor","name":"cursor","in":"query"},{"schema":{"type":"string","enum":["hour","day","week","month","year","all"],"description":"Time window for top or controversial feeds: hour, day, week, month, year, or all","example":"week"},"required":false,"description":"Time window for top or controversial feeds: hour, day, week, month, year, or all","name":"time","in":"query"}],"responses":{"200":{"description":"Returns the feed posts","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"@context":{"type":"array","prefixItems":[{"type":"string","enum":["https://www.w3.org/ns/activitystreams#"]},{"type":"string","enum":["https://konbiniapi.com/ns/social#"]}],"description":"ActivityStreams JSON-LD context","example":["https://www.w3.org/ns/activitystreams#","https://konbiniapi.com/ns/social#"]},"type":{"type":"string","description":"ActivityStreams collection type","example":"OrderedCollectionPage"},"partOf":{"type":"string","format":"uri","description":"URL of the full collection","example":"https://api.konbiniapi.com/v1/reddit/feeds/hot"},"totalItems":{"type":["integer","null"],"description":"Total number of items, null if unknown","example":1309},"cursor":{"type":["string","null"],"description":"Current page cursor, null on first page","example":null},"nextCursor":{"type":["string","null"],"description":"Cursor for the next page, null on last page","example":"t3_post_2"},"next":{"type":["string","null"],"format":"uri","description":"URL for the next page, null on last page","example":"https://api.konbiniapi.com/v1/reddit/feeds/top?cursor=t3_post_2&count=25&time=week"},"itemCount":{"type":"integer","description":"Number of items returned in this page","example":30},"orderedItems":{"type":"array","items":{"$ref":"#/components/schemas/RedditPost"},"description":"Items in this page"}},"required":["@context","type","partOf","totalItems","cursor","nextCursor","next","itemCount","orderedItems"]}},"required":["data"]}}}},"400":{"description":"Bad Request — Invalid parameters","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["validation_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Validation error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"401":{"description":"Unauthorized — Missing or invalid API key","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["missing_api_key","invalid_api_key"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Invalid API key","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"402":{"description":"Payment Required — Credits exhausted","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["credits_exhausted"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Credits exhausted. Upgrade your plan at konbiniapi.com","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"403":{"description":"Forbidden — API key disabled or expired","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["api_key_disabled","api_key_expired"],"description":"Machine-readable error code"},"message":{"type":"string","example":"API key is disabled","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"404":{"description":"Not Found","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["not_found","route_not_found"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Not found","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"413":{"description":"Content Too Large — Request body exceeds 1 MB","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["validation_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Request body too large","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"500":{"description":"Internal Server Error","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["internal_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Internal error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"502":{"description":"Bad Gateway — Upstream platform error","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["platform_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Platform error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"503":{"description":"Service Unavailable","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["service_unavailable"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Service unavailable","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"504":{"description":"Gateway Timeout — Upstream platform timed out","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["platform_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Platform error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}}}}},"/v1/reddit/search/posts":{"get":{"operationId":"redditSearchPosts","tags":["Reddit"],"summary":"Search posts","description":"Searches public Reddit posts across the platform. Supports relevance, hot, top, new, and comments sorting with optional time windows.","parameters":[{"schema":{"type":"string","minLength":1,"description":"Search query","example":"askreddit"},"required":true,"description":"Search query","name":"q","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":25,"description":"Number of posts to fetch (maximum: 100)","example":25},"required":false,"description":"Number of posts to fetch (maximum: 100)","name":"count","in":"query"},{"schema":{"type":"string","description":"Pagination cursor","example":"0"},"required":false,"description":"Pagination cursor","name":"cursor","in":"query"},{"schema":{"type":"string","enum":["relevance","hot","top","new","comments"],"default":"relevance","description":"Sort order: relevance (default), hot, top, new, or comments","example":"relevance"},"required":false,"description":"Sort order: relevance (default), hot, top, new, or comments","name":"order","in":"query"},{"schema":{"type":"string","enum":["hour","day","week","month","year","all"],"description":"Optional time window for search results: hour, day, week, month, year, or all","example":"week"},"required":false,"description":"Optional time window for search results: hour, day, week, month, year, or all","name":"time","in":"query"}],"responses":{"200":{"description":"Returns search results","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"@context":{"type":"array","prefixItems":[{"type":"string","enum":["https://www.w3.org/ns/activitystreams#"]},{"type":"string","enum":["https://konbiniapi.com/ns/social#"]}],"description":"ActivityStreams JSON-LD context","example":["https://www.w3.org/ns/activitystreams#","https://konbiniapi.com/ns/social#"]},"type":{"type":"string","description":"ActivityStreams collection type","example":"OrderedCollectionPage"},"partOf":{"type":"string","format":"uri","description":"URL of the full collection","example":"https://api.konbiniapi.com/v1/reddit/search/posts?q=openai"},"totalItems":{"type":["integer","null"],"description":"Total number of items, null if unknown","example":1309},"cursor":{"type":["string","null"],"description":"Current page cursor, null on first page","example":null},"nextCursor":{"type":["string","null"],"description":"Cursor for the next page, null on last page","example":"t3_post_2"},"next":{"type":["string","null"],"format":"uri","description":"URL for the next page, null on last page","example":"https://api.konbiniapi.com/v1/reddit/search/posts?q=openai&cursor=t3_post_2&count=25&order=top&time=week"},"itemCount":{"type":"integer","description":"Number of items returned in this page","example":30},"orderedItems":{"type":"array","items":{"$ref":"#/components/schemas/RedditPost"},"description":"Items in this page"}},"required":["@context","type","partOf","totalItems","cursor","nextCursor","next","itemCount","orderedItems"]}},"required":["data"]}}}},"400":{"description":"Bad Request — Invalid parameters","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["validation_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Validation error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"401":{"description":"Unauthorized — Missing or invalid API key","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["missing_api_key","invalid_api_key"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Invalid API key","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"402":{"description":"Payment Required — Credits exhausted","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["credits_exhausted"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Credits exhausted. Upgrade your plan at konbiniapi.com","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"403":{"description":"Forbidden — API key disabled or expired","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["api_key_disabled","api_key_expired"],"description":"Machine-readable error code"},"message":{"type":"string","example":"API key is disabled","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"404":{"description":"Not Found","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["not_found","route_not_found"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Not found","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"413":{"description":"Content Too Large — Request body exceeds 1 MB","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["validation_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Request body too large","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"500":{"description":"Internal Server Error","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["internal_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Internal error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"502":{"description":"Bad Gateway — Upstream platform error","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["platform_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Platform error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"503":{"description":"Service Unavailable","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["service_unavailable"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Service unavailable","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"504":{"description":"Gateway Timeout — Upstream platform timed out","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["platform_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Platform error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}}}}},"/v1/reddit/search/users":{"get":{"operationId":"redditSearchUsers","tags":["Reddit"],"summary":"Search users","description":"Searches public Reddit users across the platform.","parameters":[{"schema":{"type":"string","minLength":1,"description":"Search query","example":"askreddit"},"required":true,"description":"Search query","name":"q","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":25,"description":"Number of users to fetch (maximum: 100)","example":25},"required":false,"description":"Number of users to fetch (maximum: 100)","name":"count","in":"query"},{"schema":{"type":"string","description":"Pagination cursor","example":"0"},"required":false,"description":"Pagination cursor","name":"cursor","in":"query"}],"responses":{"200":{"description":"Returns matching users","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"@context":{"type":"array","prefixItems":[{"type":"string","enum":["https://www.w3.org/ns/activitystreams#"]},{"type":"string","enum":["https://konbiniapi.com/ns/social#"]}],"description":"ActivityStreams JSON-LD context","example":["https://www.w3.org/ns/activitystreams#","https://konbiniapi.com/ns/social#"]},"type":{"type":"string","description":"ActivityStreams collection type","example":"OrderedCollectionPage"},"partOf":{"type":"string","format":"uri","description":"URL of the full collection","example":"https://api.konbiniapi.com/v1/reddit/search/users?q=spez"},"totalItems":{"type":["integer","null"],"description":"Total number of items, null if unknown","example":1309},"cursor":{"type":["string","null"],"description":"Current page cursor, null on first page","example":null},"nextCursor":{"type":["string","null"],"description":"Cursor for the next page, null on last page","example":"t2_user_2"},"next":{"type":["string","null"],"format":"uri","description":"URL for the next page, null on last page","example":"https://api.konbiniapi.com/v1/reddit/search/users?q=spez&cursor=t2_user_2&count=25"},"itemCount":{"type":"integer","description":"Number of items returned in this page","example":30},"orderedItems":{"type":"array","items":{"$ref":"#/components/schemas/RedditUser"},"description":"Items in this page"}},"required":["@context","type","partOf","totalItems","cursor","nextCursor","next","itemCount","orderedItems"]}},"required":["data"]}}}},"400":{"description":"Bad Request — Invalid parameters","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["validation_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Validation error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"401":{"description":"Unauthorized — Missing or invalid API key","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["missing_api_key","invalid_api_key"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Invalid API key","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"402":{"description":"Payment Required — Credits exhausted","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["credits_exhausted"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Credits exhausted. Upgrade your plan at konbiniapi.com","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"403":{"description":"Forbidden — API key disabled or expired","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["api_key_disabled","api_key_expired"],"description":"Machine-readable error code"},"message":{"type":"string","example":"API key is disabled","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"404":{"description":"Not Found","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["not_found","route_not_found"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Not found","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"413":{"description":"Content Too Large — Request body exceeds 1 MB","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["validation_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Request body too large","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"500":{"description":"Internal Server Error","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["internal_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Internal error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"502":{"description":"Bad Gateway — Upstream platform error","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["platform_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Platform error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"503":{"description":"Service Unavailable","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["service_unavailable"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Service unavailable","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"504":{"description":"Gateway Timeout — Upstream platform timed out","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["platform_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Platform error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}}}}},"/v1/reddit/search/subreddits":{"get":{"operationId":"redditSearchSubreddits","tags":["Reddit"],"summary":"Search subreddits","description":"Searches public Reddit subreddits across the platform.","parameters":[{"schema":{"type":"string","minLength":1,"description":"Search query","example":"askreddit"},"required":true,"description":"Search query","name":"q","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":25,"description":"Number of subreddits to fetch (maximum: 100)","example":25},"required":false,"description":"Number of subreddits to fetch (maximum: 100)","name":"count","in":"query"},{"schema":{"type":"string","description":"Pagination cursor","example":"0"},"required":false,"description":"Pagination cursor","name":"cursor","in":"query"}],"responses":{"200":{"description":"Returns matching subreddits","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"@context":{"type":"array","prefixItems":[{"type":"string","enum":["https://www.w3.org/ns/activitystreams#"]},{"type":"string","enum":["https://konbiniapi.com/ns/social#"]}],"description":"ActivityStreams JSON-LD context","example":["https://www.w3.org/ns/activitystreams#","https://konbiniapi.com/ns/social#"]},"type":{"type":"string","description":"ActivityStreams collection type","example":"OrderedCollectionPage"},"partOf":{"type":"string","format":"uri","description":"URL of the full collection","example":"https://api.konbiniapi.com/v1/reddit/search/subreddits?q=programming"},"totalItems":{"type":["integer","null"],"description":"Total number of items, null if unknown","example":1309},"cursor":{"type":["string","null"],"description":"Current page cursor, null on first page","example":null},"nextCursor":{"type":["string","null"],"description":"Cursor for the next page, null on last page","example":"t5_subreddit_2"},"next":{"type":["string","null"],"format":"uri","description":"URL for the next page, null on last page","example":"https://api.konbiniapi.com/v1/reddit/search/subreddits?q=programming&cursor=t5_subreddit_2&count=25"},"itemCount":{"type":"integer","description":"Number of items returned in this page","example":30},"orderedItems":{"type":"array","items":{"$ref":"#/components/schemas/RedditSubreddit"},"description":"Items in this page"}},"required":["@context","type","partOf","totalItems","cursor","nextCursor","next","itemCount","orderedItems"]}},"required":["data"]}}}},"400":{"description":"Bad Request — Invalid parameters","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["validation_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Validation error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"401":{"description":"Unauthorized — Missing or invalid API key","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["missing_api_key","invalid_api_key"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Invalid API key","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"402":{"description":"Payment Required — Credits exhausted","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["credits_exhausted"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Credits exhausted. Upgrade your plan at konbiniapi.com","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"403":{"description":"Forbidden — API key disabled or expired","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["api_key_disabled","api_key_expired"],"description":"Machine-readable error code"},"message":{"type":"string","example":"API key is disabled","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"404":{"description":"Not Found","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["not_found","route_not_found"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Not found","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"413":{"description":"Content Too Large — Request body exceeds 1 MB","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["validation_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Request body too large","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"500":{"description":"Internal Server Error","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["internal_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Internal error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"502":{"description":"Bad Gateway — Upstream platform error","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["platform_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Platform error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"503":{"description":"Service Unavailable","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["service_unavailable"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Service unavailable","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"504":{"description":"Gateway Timeout — Upstream platform timed out","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["platform_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Platform error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}}}}},"/v1/linkedin/users/{username}":{"get":{"operationId":"linkedinGetUser","tags":["LinkedIn"],"summary":"Get user profile","description":"Returns profile information for a public LinkedIn member: headline, location, and a simple list of job titles and school/employer names. Fields the member has restricted are omitted.","parameters":[{"schema":{"type":"string","description":"LinkedIn username","example":"reidhoffman"},"required":true,"description":"LinkedIn username","name":"username","in":"path"}],"responses":{"200":{"description":"Returns the LinkedIn user profile","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"@context":{"type":"array","prefixItems":[{"type":"string","enum":["https://www.w3.org/ns/activitystreams#"]},{"type":"string","enum":["https://konbiniapi.com/ns/social#"]}],"description":"ActivityStreams JSON-LD context","example":["https://www.w3.org/ns/activitystreams#","https://konbiniapi.com/ns/social#"]},"type":{"type":"string","description":"ActivityStreams object type","example":"Person"},"id":{"type":"string","format":"uri","description":"Profile URL","example":"https://www.linkedin.com/in/reidhoffman"},"url":{"type":"string","format":"uri","description":"Profile URL","example":"https://www.linkedin.com/in/reidhoffman"},"name":{"type":"string","description":"Display name","example":"Reid Hoffman"},"preferredUsername":{"type":"string","description":"Username or handle","example":"reidhoffman"},"summary":{"type":["string","null"],"description":"Headline / short bio","example":"Creator, Top Voice"},"location":{"type":"string","description":"Locality, region, country","example":"United States, US"},"address":{"$ref":"#/components/schemas/LinkedInAddress"},"followerCount":{"type":"integer","description":"Follower/connection count","example":2783363},"icon":{"$ref":"#/components/schemas/LinkedInImage"},"role":{"type":"array","items":{"type":"string"},"description":"Job titles held (omits entries LinkedIn redacts for this member)","example":["Co-Founder, Executive Board Chair","Co-Founder, Board Member"]},"affiliation":{"type":"array","items":{"type":"string"},"description":"Employer names (omits redacted entries)","example":["Manas AI","Greylock"]},"education":{"type":"array","items":{"type":"string"},"description":"School/university names (omits redacted entries)","example":["Stanford University","Oxford University"]},"language":{"type":"array","items":{"type":"string"},"description":"Languages the member lists as known","example":["English"]}},"required":["@context","type","id","url","name","preferredUsername","summary"]}},"required":["data"]}}}},"400":{"description":"Bad Request — Invalid parameters","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["validation_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Validation error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"401":{"description":"Unauthorized — Missing or invalid API key","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["missing_api_key","invalid_api_key"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Invalid API key","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"402":{"description":"Payment Required — Credits exhausted","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["credits_exhausted"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Credits exhausted. Upgrade your plan at konbiniapi.com","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"403":{"description":"Forbidden — API key disabled or expired","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["api_key_disabled","api_key_expired"],"description":"Machine-readable error code"},"message":{"type":"string","example":"API key is disabled","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"404":{"description":"Not Found","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["not_found","route_not_found"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Not found","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"413":{"description":"Content Too Large — Request body exceeds 1 MB","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["validation_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Request body too large","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"500":{"description":"Internal Server Error","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["internal_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Internal error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"502":{"description":"Bad Gateway — Upstream platform error","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["platform_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Platform error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"503":{"description":"Service Unavailable","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["service_unavailable"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Service unavailable","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"504":{"description":"Gateway Timeout — Upstream platform timed out","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["platform_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Platform error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}}}}},"/v1/linkedin/users/{username}/articles":{"get":{"operationId":"linkedinGetUserArticles","tags":["LinkedIn"],"summary":"Get user articles","description":"Returns a public LinkedIn member's published articles. This endpoint is not paginated — everything available is returned in a single response.","parameters":[{"schema":{"type":"string","description":"LinkedIn username","example":"reidhoffman"},"required":true,"description":"LinkedIn username","name":"username","in":"path"}],"responses":{"200":{"description":"Returns the member’s published articles","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"@context":{"type":"array","prefixItems":[{"type":"string","enum":["https://www.w3.org/ns/activitystreams#"]},{"type":"string","enum":["https://konbiniapi.com/ns/social#"]}],"description":"ActivityStreams JSON-LD context","example":["https://www.w3.org/ns/activitystreams#","https://konbiniapi.com/ns/social#"]},"type":{"type":"string","enum":["OrderedCollection"]},"id":{"type":"string","format":"uri","description":"Collection permalink","example":"https://www.linkedin.com/in/reidhoffman/articles/"},"url":{"type":"string","format":"uri","description":"Collection permalink","example":"https://www.linkedin.com/in/reidhoffman/articles/"},"totalItems":{"type":"integer","description":"Number of articles returned","example":1},"orderedItems":{"type":"array","items":{"$ref":"#/components/schemas/LinkedInArticle"},"description":"Published articles"}},"required":["@context","type","id","url","totalItems","orderedItems"]}},"required":["data"]}}}},"400":{"description":"Bad Request — Invalid parameters","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["validation_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Validation error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"401":{"description":"Unauthorized — Missing or invalid API key","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["missing_api_key","invalid_api_key"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Invalid API key","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"402":{"description":"Payment Required — Credits exhausted","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["credits_exhausted"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Credits exhausted. Upgrade your plan at konbiniapi.com","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"403":{"description":"Forbidden — API key disabled or expired","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["api_key_disabled","api_key_expired"],"description":"Machine-readable error code"},"message":{"type":"string","example":"API key is disabled","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"404":{"description":"Not Found","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["not_found","route_not_found"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Not found","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"413":{"description":"Content Too Large — Request body exceeds 1 MB","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["validation_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Request body too large","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"500":{"description":"Internal Server Error","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["internal_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Internal error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"502":{"description":"Bad Gateway — Upstream platform error","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["platform_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Platform error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"503":{"description":"Service Unavailable","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["service_unavailable"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Service unavailable","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"504":{"description":"Gateway Timeout — Upstream platform timed out","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["platform_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Platform error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}}}}},"/v1/linkedin/users/{username}/posts":{"get":{"operationId":"linkedinGetUserPosts","tags":["LinkedIn"],"summary":"Get user posts","description":"Returns a public LinkedIn member's recent posts and shares. This endpoint is not paginated — everything available is returned in a single response.","parameters":[{"schema":{"type":"string","description":"LinkedIn username","example":"reidhoffman"},"required":true,"description":"LinkedIn username","name":"username","in":"path"}],"responses":{"200":{"description":"Returns the member’s recent posts","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"@context":{"type":"array","prefixItems":[{"type":"string","enum":["https://www.w3.org/ns/activitystreams#"]},{"type":"string","enum":["https://konbiniapi.com/ns/social#"]}],"description":"ActivityStreams JSON-LD context","example":["https://www.w3.org/ns/activitystreams#","https://konbiniapi.com/ns/social#"]},"type":{"type":"string","enum":["OrderedCollection"]},"id":{"type":"string","format":"uri","description":"Collection permalink","example":"https://www.linkedin.com/in/reidhoffman/posts/"},"url":{"type":"string","format":"uri","description":"Collection permalink","example":"https://www.linkedin.com/in/reidhoffman/posts/"},"totalItems":{"type":"integer","description":"Number of posts returned","example":1},"orderedItems":{"type":"array","items":{"$ref":"#/components/schemas/LinkedInRecentPost"},"description":"Recent posts/shares"}},"required":["@context","type","id","url","totalItems","orderedItems"]}},"required":["data"]}}}},"400":{"description":"Bad Request — Invalid parameters","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["validation_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Validation error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"401":{"description":"Unauthorized — Missing or invalid API key","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["missing_api_key","invalid_api_key"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Invalid API key","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"402":{"description":"Payment Required — Credits exhausted","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["credits_exhausted"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Credits exhausted. Upgrade your plan at konbiniapi.com","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"403":{"description":"Forbidden — API key disabled or expired","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["api_key_disabled","api_key_expired"],"description":"Machine-readable error code"},"message":{"type":"string","example":"API key is disabled","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"404":{"description":"Not Found","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["not_found","route_not_found"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Not found","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"413":{"description":"Content Too Large — Request body exceeds 1 MB","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["validation_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Request body too large","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"500":{"description":"Internal Server Error","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["internal_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Internal error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"502":{"description":"Bad Gateway — Upstream platform error","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["platform_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Platform error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"503":{"description":"Service Unavailable","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["service_unavailable"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Service unavailable","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"504":{"description":"Gateway Timeout — Upstream platform timed out","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["platform_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Platform error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}}}}},"/v1/linkedin/companies/{company}":{"get":{"operationId":"linkedinGetCompany","tags":["LinkedIn"],"summary":"Get company page","description":"Returns public information for a LinkedIn company page including description, location, employee count, and logo.","parameters":[{"schema":{"type":"string","description":"Company vanity name","example":"stripe"},"required":true,"description":"Company vanity name","name":"company","in":"path"}],"responses":{"200":{"description":"Returns the LinkedIn company page","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"@context":{"type":"array","prefixItems":[{"type":"string","enum":["https://www.w3.org/ns/activitystreams#"]},{"type":"string","enum":["https://konbiniapi.com/ns/social#"]}],"description":"ActivityStreams JSON-LD context","example":["https://www.w3.org/ns/activitystreams#","https://konbiniapi.com/ns/social#"]},"type":{"type":"string","description":"ActivityStreams object type","example":"Organization"},"id":{"type":"string","format":"uri","description":"Company page URL","example":"https://www.linkedin.com/company/stripe"},"url":{"type":"string","format":"uri","description":"Company page URL","example":"https://www.linkedin.com/company/stripe"},"name":{"type":"string","description":"Company name","example":"Stripe"},"preferredUsername":{"type":"string","description":"Company vanity name","example":"stripe"},"summary":{"type":["string","null"],"description":"Company description","example":"Stripe builds programmable financial services. Millions of companies—from the world's largest enterprises to the most ambitious startups—use Stripe to accept payments, grow their revenue, and accelerate new business opportunities. Headquartered in San Francisco and Dublin, the company aims to increase the GDP of the internet."},"location":{"type":"string","description":"Locality, region, country","example":"South San Francisco, California, US"},"address":{"allOf":[{"$ref":"#/components/schemas/LinkedInAddress"},{"example":{"streetAddress":"354 Oyster Point Blvd","addressLocality":"South San Francisco","addressRegion":"California","postalCode":"94080","addressCountry":"US"}}]},"memberCount":{"type":"integer","description":"Reported employee count","example":16907},"icon":{"allOf":[{"$ref":"#/components/schemas/LinkedInImage"},{"description":"Company logo"}]},"tagline":{"type":"string","description":"Company slogan/tagline","example":"Help increase the GDP of the internet."},"attachment":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","enum":["Link"]},"href":{"type":"string","format":"uri"}},"required":["type","href"]},"description":"External company links","example":[{"type":"Link","href":"https://stripe.com"}]}},"required":["@context","type","id","url","name","preferredUsername","summary"]}},"required":["data"]}}}},"400":{"description":"Bad Request — Invalid parameters","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["validation_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Validation error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"401":{"description":"Unauthorized — Missing or invalid API key","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["missing_api_key","invalid_api_key"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Invalid API key","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"402":{"description":"Payment Required — Credits exhausted","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["credits_exhausted"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Credits exhausted. Upgrade your plan at konbiniapi.com","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"403":{"description":"Forbidden — API key disabled or expired","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["api_key_disabled","api_key_expired"],"description":"Machine-readable error code"},"message":{"type":"string","example":"API key is disabled","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"404":{"description":"Not Found","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["not_found","route_not_found"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Not found","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"413":{"description":"Content Too Large — Request body exceeds 1 MB","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["validation_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Request body too large","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"500":{"description":"Internal Server Error","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["internal_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Internal error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"502":{"description":"Bad Gateway — Upstream platform error","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["platform_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Platform error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"503":{"description":"Service Unavailable","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["service_unavailable"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Service unavailable","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"504":{"description":"Gateway Timeout — Upstream platform timed out","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["platform_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Platform error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}}}}},"/v1/linkedin/companies/{company}/posts":{"get":{"operationId":"linkedinGetCompanyPosts","tags":["LinkedIn"],"summary":"Get company posts","description":"Returns recent posts from a LinkedIn company page, newest first. Use `cursor` to page through further results.","parameters":[{"schema":{"type":"string","description":"Company vanity name","example":"stripe"},"required":true,"description":"Company vanity name","name":"company","in":"path"},{"schema":{"type":"string","description":"Pagination cursor","example":"0"},"required":false,"description":"Pagination cursor","name":"cursor","in":"query"}],"responses":{"200":{"description":"Returns posts from this company page","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"@context":{"type":"array","prefixItems":[{"type":"string","enum":["https://www.w3.org/ns/activitystreams#"]},{"type":"string","enum":["https://konbiniapi.com/ns/social#"]}],"description":"ActivityStreams JSON-LD context","example":["https://www.w3.org/ns/activitystreams#","https://konbiniapi.com/ns/social#"]},"type":{"type":"string","description":"ActivityStreams collection type","example":"OrderedCollectionPage"},"partOf":{"type":"string","format":"uri","description":"URL of the full collection","example":"https://api.konbiniapi.com/v1/linkedin/companies/stripe/posts"},"totalItems":{"type":["integer","null"],"description":"Total number of items, null if unknown","example":null},"cursor":{"type":["string","null"],"description":"Current page cursor, null on first page","example":null},"nextCursor":{"type":["string","null"],"description":"Cursor for the next page, null on last page","example":"eyJvIjoi"},"next":{"type":["string","null"],"format":"uri","description":"URL for the next page, null on last page","example":"https://api.konbiniapi.com/v1/linkedin/companies/stripe/posts?cursor=eyJvIjoi"},"itemCount":{"type":"integer","description":"Number of items returned in this page","example":30},"orderedItems":{"type":"array","items":{"$ref":"#/components/schemas/LinkedInCompanyPost"},"description":"Items in this page"}},"required":["@context","type","partOf","totalItems","cursor","nextCursor","next","itemCount","orderedItems"]}},"required":["data"]}}}},"400":{"description":"Bad Request — Invalid parameters","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["validation_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Validation error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"401":{"description":"Unauthorized — Missing or invalid API key","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["missing_api_key","invalid_api_key"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Invalid API key","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"402":{"description":"Payment Required — Credits exhausted","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["credits_exhausted"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Credits exhausted. Upgrade your plan at konbiniapi.com","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"403":{"description":"Forbidden — API key disabled or expired","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["api_key_disabled","api_key_expired"],"description":"Machine-readable error code"},"message":{"type":"string","example":"API key is disabled","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"404":{"description":"Not Found","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["not_found","route_not_found"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Not found","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"413":{"description":"Content Too Large — Request body exceeds 1 MB","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["validation_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Request body too large","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"500":{"description":"Internal Server Error","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["internal_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Internal error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"502":{"description":"Bad Gateway — Upstream platform error","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["platform_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Platform error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"503":{"description":"Service Unavailable","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["service_unavailable"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Service unavailable","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"504":{"description":"Gateway Timeout — Upstream platform timed out","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["platform_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Platform error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}}}}},"/v1/linkedin/posts/{postId}":{"get":{"operationId":"linkedinGetPost","tags":["LinkedIn"],"summary":"Get post","description":"Returns a public LinkedIn post including author, engagement counts, and up to ~5 inline comments.","parameters":[{"schema":{"type":"string","description":"LinkedIn post activity ID: the full slug (from linkedin.com/posts/{id}), a bare `urn:li:activity:{id}` (from linkedin.com/feed/update/{urn}/), or a bare numeric activity ID (e.g. `7476310414297968640`)","example":"stripe_new-providers-on-stripe-projects-are-available-activity-7483253516766109696-xCr3"},"required":true,"description":"LinkedIn post activity ID: the full slug (from linkedin.com/posts/{id}), a bare `urn:li:activity:{id}` (from linkedin.com/feed/update/{urn}/), or a bare numeric activity ID (e.g. `7476310414297968640`)","name":"postId","in":"path"}],"responses":{"200":{"description":"Returns the LinkedIn post","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"@context":{"type":"array","prefixItems":[{"type":"string","enum":["https://www.w3.org/ns/activitystreams#"]},{"type":"string","enum":["https://konbiniapi.com/ns/social#"]}],"description":"ActivityStreams JSON-LD context","example":["https://www.w3.org/ns/activitystreams#","https://konbiniapi.com/ns/social#"]},"type":{"type":"string","description":"ActivityStreams object type","example":"Note"},"id":{"type":"string","format":"uri","description":"Post permalink","example":"https://www.linkedin.com/posts/stripe_new-providers-on-stripe-projects-are-available-activity-7483253516766109696-xCr3"},"url":{"type":"string","format":"uri","description":"Post permalink","example":"https://www.linkedin.com/posts/stripe_new-providers-on-stripe-projects-are-available-activity-7483253516766109696-xCr3"},"entityId":{"type":"string","description":"Numeric activity ID, usable directly as :postId on GET /posts/:postId","example":"7483253516766109696"},"content":{"type":"string","description":"Comment text","example":"New providers on Stripe Projects are available now:\n\nChatbase\nComposio\nNodeOps\nCustomer.io\nDatadog"},"published":{"type":"string","format":"date-time","description":"Publication date in ISO 8601 format","example":"2026-07-15T20:17:50.459Z"},"likeCount":{"type":"integer","description":"Number of likes","example":185},"replyCount":{"type":"integer","description":"Number of replies","example":39},"attributedTo":{"type":"object","properties":{"type":{"type":"string","description":"ActivityStreams object type","example":"Person"},"id":{"type":"string","format":"uri","description":"Author profile URL (stable identifier)","example":"https://www.linkedin.com/in/janedoe"},"url":{"type":"string","format":"uri","description":"Author profile URL","example":"https://www.linkedin.com/in/janedoe"},"name":{"type":"string","description":"Author display name","example":"Jane Doe"},"preferredUsername":{"type":"string","description":"Author username — looks the author up via GET /users/:username","example":"janedoe"},"followerCount":{"type":"integer","description":"Author follower count","example":12000}},"required":["type"],"description":"Post author","example":{"type":"Organization","id":"https://www.linkedin.com/company/stripe","url":"https://www.linkedin.com/company/stripe","name":"Stripe","preferredUsername":"stripe","followerCount":1601918}},"image":{"type":"array","items":{"allOf":[{"$ref":"#/components/schemas/LinkedInImage"},{"description":"Image resource"}]},"description":"Thumbnail images","example":[{"type":"Image","url":"https://media.licdn.com/dms/image/v2/D4E05AQGnh5Qo2aZfGw/videocover-high/B4EZ9nRqAzJEBM-/0/1784144110876"}]},"attachment":{"type":"array","items":{"$ref":"#/components/schemas/LinkedInVideoAttachment"},"description":"Video attachment, when present","example":[{"type":"Video","url":["https://dms.licdn.com/playlist/vid/v2/D4E05AQGnh5Qo2aZfGw/mp4-720p-30fp-crf28/B4EZ9nRqAzJEB8-/0/1784144111064"],"mediaType":"video/mp4","duration":4,"preview":{"type":"Image","url":"https://media.licdn.com/dms/image/v2/D4E05AQGnh5Qo2aZfGw/videocover-high/B4EZ9nRqAzJEBM-/0/1784144110876"}}]},"replies":{"type":"array","items":{"$ref":"#/components/schemas/LinkedInComment"},"description":"Inline comments — LinkedIn exposes at most ~5 anonymously, this is not the full thread"}},"required":["@context","type","id","url","content"]}},"required":["data"]}}}},"400":{"description":"Bad Request — Invalid parameters","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["validation_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Validation error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"401":{"description":"Unauthorized — Missing or invalid API key","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["missing_api_key","invalid_api_key"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Invalid API key","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"402":{"description":"Payment Required — Credits exhausted","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["credits_exhausted"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Credits exhausted. Upgrade your plan at konbiniapi.com","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"403":{"description":"Forbidden — API key disabled or expired","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["api_key_disabled","api_key_expired"],"description":"Machine-readable error code"},"message":{"type":"string","example":"API key is disabled","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"404":{"description":"Not Found","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["not_found","route_not_found"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Not found","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"413":{"description":"Content Too Large — Request body exceeds 1 MB","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["validation_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Request body too large","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"500":{"description":"Internal Server Error","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["internal_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Internal error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"502":{"description":"Bad Gateway — Upstream platform error","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["platform_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Platform error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"503":{"description":"Service Unavailable","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["service_unavailable"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Service unavailable","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"504":{"description":"Gateway Timeout — Upstream platform timed out","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["platform_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Platform error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}}}}},"/v1/linkedin/posts/{postId}/transcript":{"get":{"operationId":"linkedinGetPostTranscript","tags":["LinkedIn"],"summary":"Get post video transcript","description":"Returns the caption/transcript for a video post, when the post carries captions. Returns 404 if the post has no video or no captions.","parameters":[{"schema":{"type":"string","description":"LinkedIn post activity ID: the full slug (from linkedin.com/posts/{id}), a bare `urn:li:activity:{id}` (from linkedin.com/feed/update/{urn}/), or a bare numeric activity ID (e.g. `7476310414297968640`)","example":"google_how-to-use-study-notebooks-in-the-gemini-activity-7483258151840993280-KA0r"},"required":true,"description":"LinkedIn post activity ID: the full slug (from linkedin.com/posts/{id}), a bare `urn:li:activity:{id}` (from linkedin.com/feed/update/{urn}/), or a bare numeric activity ID (e.g. `7476310414297968640`)","name":"postId","in":"path"}],"responses":{"200":{"description":"Returns the transcript in Document format or raw caption content (WebVTT or SRT, matching the source)","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"@context":{"type":"array","prefixItems":[{"type":"string","enum":["https://www.w3.org/ns/activitystreams#"]},{"type":"string","enum":["https://konbiniapi.com/ns/social#"]}],"description":"ActivityStreams JSON-LD context","example":["https://www.w3.org/ns/activitystreams#","https://konbiniapi.com/ns/social#"]},"type":{"type":"string","description":"ActivityStreams object type","example":"Document"},"id":{"type":"string","format":"uri","description":"Transcript permalink","example":"https://www.linkedin.com/posts/google_how-to-use-study-notebooks-in-the-gemini-activity-7483258151840993280-KA0r/transcript"},"url":{"type":"string","format":"uri","description":"Post permalink","example":"https://www.linkedin.com/posts/google_how-to-use-study-notebooks-in-the-gemini-activity-7483258151840993280-KA0r"},"mediaType":{"type":"string","description":"MIME type as LinkedIn serves it for this caption track — observed as both text/vtt (WebVTT) and application/x-subrip (SRT)","example":"text/vtt"},"size":{"type":"integer","description":"File size in bytes","example":977},"content":{"type":"string","description":"Transcript/caption content, in whatever format mediaType names","example":"WEBVTT\n\n00:00.000 --> 00:03.000\nOpen the Gemini app and select \"New notebook.\"\n\n00:03.000 --> 00:06.500\nTell Gemini what you're studying for and upload your class notes or readings.\n\n00:06.500 --> 00:10.000\nGemini will give you a quick diagnostic quiz to find your exact knowledge gaps.\n\n00:10.000 --> 00:14.000\nThen it creates short, bite-sized lessons to help you learn what you don't know.\n\n00:14.000 --> 00:18.500\nAnd it builds an interactive learning dashboard tracking your progress\n\n00:18.500 --> 00:21.500\nacross more than a hundred specific study goals\n\n00:21.500 --> 00:24.500\nand labeling them as strengths or focus areas,\n\n00:24.500 --> 00:27.500\nso you never have to guess what to study next.\n\n00:27.500 --> 00:30.500\nPlus it connects directly with NotebookLM, meaning you can\n\n00:30.500 --> 00:33.500\ninstantly generate interactive flashcards,\naudio overviews, and more from your files.\n\n00:33.500 --> 00:36.500\nCool, right? Try it out yourself at gemini.google.\n"}},"required":["@context","type","id","url","mediaType","content"]}},"required":["data"]}},"text/vtt":{"schema":{"type":"string","example":"WEBVTT\n\n00:00.000 --> 00:03.000\nOpen the Gemini app and select \"New notebook.\"\n\n00:03.000 --> 00:06.500\nTell Gemini what you're studying for and upload your class notes or readings."}},"application/x-subrip":{"schema":{"type":"string","example":"1\n00:00:00,060 --> 00:00:02,571\nBut now, because anybody can code, what happens is the\n\n2\n00:00:02,571 --> 00:00:05,173\nsoftware people play the role of the architect"}}}},"400":{"description":"Bad Request — Invalid parameters","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["validation_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Validation error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"401":{"description":"Unauthorized — Missing or invalid API key","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["missing_api_key","invalid_api_key"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Invalid API key","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"402":{"description":"Payment Required — Credits exhausted","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["credits_exhausted"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Credits exhausted. Upgrade your plan at konbiniapi.com","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"403":{"description":"Forbidden — API key disabled or expired","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["api_key_disabled","api_key_expired"],"description":"Machine-readable error code"},"message":{"type":"string","example":"API key is disabled","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"404":{"description":"Not Found","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["not_found","route_not_found"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Not found","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"413":{"description":"Content Too Large — Request body exceeds 1 MB","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["validation_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Request body too large","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"500":{"description":"Internal Server Error","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["internal_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Internal error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"502":{"description":"Bad Gateway — Upstream platform error","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["platform_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Platform error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"503":{"description":"Service Unavailable","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["service_unavailable"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Service unavailable","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}},"504":{"description":"Gateway Timeout — Upstream platform timed out","headers":{"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credits remaining after this request"},"X-Credits-Used":{"schema":{"type":"integer"},"description":"Credits consumed (1 if charged, 0 if refunded on error)"}},"content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["platform_error"],"description":"Machine-readable error code"},"message":{"type":"string","example":"Platform error","description":"Human-readable error message"}},"required":["code","message"]},"description":"List of errors"},"data":{"type":"null","description":"Always null for error responses"}},"required":["errors","data"]}}}}}}}},"webhooks":{}}