{"components":{"schemas":{"ErrorEnvelope":{"properties":{"error":{"properties":{"code":{"type":"string"},"details":{"additionalProperties":true,"type":"object"},"message":{"type":"string"},"requestId":{"type":"string"},"retryable":{"type":"boolean"}},"required":["code","message","requestId","retryable"],"type":"object"}},"required":["error"],"type":"object"},"InstagramAudio":{"additionalProperties":false,"properties":{"artist":{"anyOf":[{"$ref":"#/components/schemas/InstagramProfileReference"},{"type":"null"}]},"artistId":{"minLength":1,"type":["string","null"]},"artistName":{"minLength":1,"type":["string","null"]},"artwork":{"anyOf":[{"$ref":"#/components/schemas/InstagramImage"},{"type":"null"}]},"clusterId":{"minLength":1,"type":["string","null"]},"compositionStartTime":{"type":["number","null"]},"createdAt":{"format":"date-time","minLength":1,"type":["string","null"]},"duration":{"type":["number","null"]},"fastStartUrl":{"format":"uri","minLength":1,"type":["string","null"]},"filters":{"items":{},"type":["array","null"]},"hasLyrics":{"type":["boolean","null"]},"highlightStartTimes":{"items":{"type":"number"},"type":["array","null"]},"id":{"minLength":1,"type":"string"},"isAutomaticallyAttributed":{"type":["boolean","null"]},"isCrosspostedFromFacebook":{"type":["boolean","null"]},"isExplicit":{"type":["boolean","null"]},"isTrending":{"type":["boolean","null"]},"metrics":{"$ref":"#/components/schemas/InstagramAudioMetrics"},"monetizationType":{"minLength":1,"type":["string","null"]},"musicId":{"minLength":1,"type":["string","null"]},"originalPostId":{"minLength":1,"type":["string","null"]},"overlapDuration":{"type":["number","null"]},"parts":{"items":{"$ref":"#/components/schemas/InstagramAudioPart"},"type":["array","null"]},"previewUrl":{"format":"uri","minLength":1,"type":["string","null"]},"spotify":{"additionalProperties":false,"properties":{"id":{"minLength":1,"type":["string","null"]},"url":{"format":"uri","minLength":1,"type":["string","null"]}},"required":["id","url"],"type":"object"},"startTime":{"type":["number","null"]},"streaming":{"anyOf":[{"$ref":"#/components/schemas/InstagramStreaming"},{"type":"null"}]},"subtype":{"minLength":1,"type":["string","null"]},"title":{"minLength":1,"type":["string","null"]},"type":{"minLength":1,"type":["string","null"]},"url":{"format":"uri","minLength":1,"type":["string","null"]}},"required":["id","type","musicId","artistId","clusterId","title","artistName","artist","isExplicit","hasLyrics","isTrending","subtype","isAutomaticallyAttributed","isCrosspostedFromFacebook","monetizationType","duration","startTime","overlapDuration","compositionStartTime","createdAt","originalPostId","url","fastStartUrl","previewUrl","artwork","streaming","highlightStartTimes","filters","metrics","spotify","parts"],"type":"object"},"InstagramAudioMetrics":{"additionalProperties":false,"properties":{"photos":{"type":["integer","null"]},"previousTrendRank":{"type":["integer","null"]},"reels":{"type":["integer","null"]},"trendRank":{"type":["integer","null"]}},"required":["trendRank","previousTrendRank","reels","photos"],"type":"object"},"InstagramAudioPart":{"additionalProperties":false,"properties":{"artist":{"anyOf":[{"$ref":"#/components/schemas/InstagramProfileReference"},{"type":"null"}]},"artistName":{"minLength":1,"type":["string","null"]},"artwork":{"anyOf":[{"$ref":"#/components/schemas/InstagramImage"},{"type":"null"}]},"isExplicit":{"type":["boolean","null"]},"musicId":{"minLength":1,"type":["string","null"]},"parentStartTime":{"type":["number","null"]},"startTime":{"type":["number","null"]},"title":{"minLength":1,"type":["string","null"]},"type":{"minLength":1,"type":["string","null"]}},"required":["type","title","artistName","isExplicit","musicId","artist","startTime","parentStartTime","artwork"],"type":"object"},"InstagramAudioReference":{"additionalProperties":false,"properties":{"artist":{"anyOf":[{"$ref":"#/components/schemas/InstagramProfileReference"},{"type":"null"}]},"artistId":{"minLength":1,"type":["string","null"]},"artistName":{"minLength":1,"type":["string","null"]},"artwork":{"anyOf":[{"$ref":"#/components/schemas/InstagramImage"},{"type":"null"}]},"clusterId":{"minLength":1,"type":["string","null"]},"compositionStartTime":{"type":["number","null"]},"createdAt":{"format":"date-time","minLength":1,"type":["string","null"]},"duration":{"type":["number","null"]},"fastStartUrl":{"format":"uri","minLength":1,"type":["string","null"]},"filters":{"items":{},"type":["array","null"]},"hasLyrics":{"type":["boolean","null"]},"highlightStartTimes":{"items":{"type":"number"},"type":["array","null"]},"id":{"minLength":1,"type":["string","null"]},"isAutomaticallyAttributed":{"type":["boolean","null"]},"isCrosspostedFromFacebook":{"type":["boolean","null"]},"isExplicit":{"type":["boolean","null"]},"isTrending":{"type":["boolean","null"]},"metrics":{"$ref":"#/components/schemas/InstagramAudioMetrics"},"monetizationType":{"minLength":1,"type":["string","null"]},"musicId":{"minLength":1,"type":["string","null"]},"originalPostId":{"minLength":1,"type":["string","null"]},"overlapDuration":{"type":["number","null"]},"parts":{"items":{"$ref":"#/components/schemas/InstagramAudioPart"},"type":["array","null"]},"previewUrl":{"format":"uri","minLength":1,"type":["string","null"]},"spotify":{"additionalProperties":false,"properties":{"id":{"minLength":1,"type":["string","null"]},"url":{"format":"uri","minLength":1,"type":["string","null"]}},"required":["id","url"],"type":"object"},"startTime":{"type":["number","null"]},"streaming":{"anyOf":[{"$ref":"#/components/schemas/InstagramStreaming"},{"type":"null"}]},"subtype":{"minLength":1,"type":["string","null"]},"title":{"minLength":1,"type":["string","null"]},"type":{"minLength":1,"type":["string","null"]},"url":{"format":"uri","minLength":1,"type":["string","null"]}},"required":["id","type","musicId","artistId","clusterId","title","artistName","artist","isExplicit","hasLyrics","isTrending","subtype","isAutomaticallyAttributed","isCrosspostedFromFacebook","monetizationType","duration","startTime","overlapDuration","compositionStartTime","createdAt","originalPostId","url","fastStartUrl","previewUrl","artwork","streaming","highlightStartTimes","filters","metrics","spotify","parts"],"type":"object"},"InstagramBioLink":{"additionalProperties":false,"properties":{"icon":{"anyOf":[{"$ref":"#/components/schemas/InstagramImage"},{"type":"null"}]},"id":{"minLength":1,"type":["string","null"]},"image":{"anyOf":[{"$ref":"#/components/schemas/InstagramImage"},{"type":"null"}]},"isPinned":{"type":["boolean","null"]},"isVerified":{"type":["boolean","null"]},"title":{"minLength":1,"type":["string","null"]},"type":{"minLength":1,"type":["string","null"]},"url":{"format":"uri","minLength":1,"type":["string","null"]}},"required":["id","title","url","type","isPinned","isVerified","icon","image"],"type":"object"},"InstagramCaptionReference":{"additionalProperties":false,"properties":{"createdAt":{"format":"date-time","minLength":1,"type":["string","null"]},"id":{"minLength":1,"type":["string","null"]},"isCovered":{"type":["boolean","null"]},"isEdited":{"type":["boolean","null"]},"ranking":{"additionalProperties":false,"properties":{"isRanked":{"type":["boolean","null"]}},"required":["isRanked"],"type":"object"},"sharingEnabled":{"type":["boolean","null"]},"status":{"minLength":1,"type":["string","null"]},"translation":{"additionalProperties":false,"properties":{"text":{"minLength":1,"type":["string","null"]}},"required":["text"],"type":"object"}},"required":["id","createdAt","status","isCovered","isEdited","sharingEnabled","ranking","translation"],"type":"object"},"InstagramClipMetadata":{"additionalProperties":false,"properties":{"audio":{"anyOf":[{"$ref":"#/components/schemas/InstagramAudioReference"},{"type":"null"}]},"partial":{"anyOf":[{"$ref":"#/components/schemas/InstagramPartialData"},{"type":"null"}]},"postId":{"minLength":1,"type":["string","null"]}},"required":["postId","audio","partial"],"type":"object"},"InstagramComment":{"additionalProperties":false,"properties":{"ai":{"additionalProperties":false,"properties":{"type":{"minLength":1,"type":["string","null"]}},"required":["type"],"type":"object"},"author":{"anyOf":[{"$ref":"#/components/schemas/InstagramProfileReference"},{"type":"null"}]},"createdAt":{"format":"date-time","minLength":1,"type":"string"},"extracted":{"$ref":"#/components/schemas/InstagramExtracted"},"id":{"minLength":1,"type":"string"},"isByPostAuthor":{"type":["boolean","null"]},"isCovered":{"type":["boolean","null"]},"isEdited":{"type":["boolean","null"]},"isLikedByPostAuthor":{"type":["boolean","null"]},"isPinned":{"type":["boolean","null"]},"keywords":{"items":{},"type":["array","null"]},"likedByCoauthors":{"items":{"$ref":"#/components/schemas/InstagramProfileReference"},"type":["array","null"]},"media":{"items":{"$ref":"#/components/schemas/InstagramImage"},"type":["array","null"]},"metrics":{"$ref":"#/components/schemas/InstagramCommentMetrics"},"parentId":{"minLength":1,"type":["string","null"]},"pinnedPosition":{"type":["integer","null"]},"postId":{"minLength":1,"type":["string","null"]},"previewUsers":{"items":{"$ref":"#/components/schemas/InstagramProfileReference"},"type":["array","null"]},"ranking":{"additionalProperties":false,"properties":{"index":{"type":["integer","null"]},"isRanked":{"type":["boolean","null"]},"replyIndex":{"type":["integer","null"]}},"required":["index","replyIndex","isRanked"],"type":"object"},"replies":{"items":{"$ref":"#/components/schemas/InstagramCommentReference"},"type":["array","null"]},"replyToId":{"minLength":1,"type":["string","null"]},"sharingEnabled":{"type":["boolean","null"]},"status":{"minLength":1,"type":["string","null"]},"text":{"minLength":1,"type":["string","null"]},"translation":{"additionalProperties":false,"properties":{"text":{"minLength":1,"type":["string","null"]}},"required":["text"],"type":"object"}},"required":["id","text","extracted","postId","parentId","replyToId","createdAt","author","status","isCovered","isEdited","sharingEnabled","isByPostAuthor","isPinned","pinnedPosition","isLikedByPostAuthor","ai","ranking","keywords","previewUsers","metrics","replies","translation","likedByCoauthors","media"],"type":"object"},"InstagramCommentMetadata":{"additionalProperties":false,"properties":{"comments":{"$ref":"#/components/schemas/InstagramCommentSettings"},"metrics":{"additionalProperties":false,"properties":{"comments":{"type":["integer","null"]}},"required":["comments"],"type":"object"},"postId":{"minLength":1,"type":["string","null"]}},"required":["postId","metrics","comments"],"type":"object"},"InstagramCommentMetrics":{"additionalProperties":false,"properties":{"likes":{"type":["integer","null"]},"replies":{"type":["integer","null"]}},"required":["likes","replies"],"type":"object"},"InstagramCommentModeration":{"additionalProperties":false,"properties":{"isOffensive":{"type":["boolean","null"]}},"required":["isOffensive"],"type":"object"},"InstagramCommentReference":{"additionalProperties":false,"properties":{"ai":{"additionalProperties":false,"properties":{"type":{"minLength":1,"type":["string","null"]}},"required":["type"],"type":"object"},"author":{"anyOf":[{"$ref":"#/components/schemas/InstagramProfileReference"},{"type":"null"}]},"createdAt":{"format":"date-time","minLength":1,"type":["string","null"]},"extracted":{"$ref":"#/components/schemas/InstagramExtracted"},"id":{"minLength":1,"type":["string","null"]},"isByPostAuthor":{"type":["boolean","null"]},"isCovered":{"type":["boolean","null"]},"isEdited":{"type":["boolean","null"]},"isLikedByPostAuthor":{"type":["boolean","null"]},"isPinned":{"type":["boolean","null"]},"keywords":{"items":{},"type":["array","null"]},"likedByCoauthors":{"items":{"$ref":"#/components/schemas/InstagramProfileReference"},"type":["array","null"]},"media":{"items":{"$ref":"#/components/schemas/InstagramImage"},"type":["array","null"]},"metrics":{"$ref":"#/components/schemas/InstagramCommentMetrics"},"parentId":{"minLength":1,"type":["string","null"]},"pinnedPosition":{"type":["integer","null"]},"postId":{"minLength":1,"type":["string","null"]},"previewUsers":{"items":{"$ref":"#/components/schemas/InstagramProfileReference"},"type":["array","null"]},"ranking":{"additionalProperties":false,"properties":{"index":{"type":["integer","null"]},"isRanked":{"type":["boolean","null"]},"replyIndex":{"type":["integer","null"]}},"required":["index","replyIndex","isRanked"],"type":"object"},"replies":{"items":{"$ref":"#/components/schemas/InstagramCommentReference"},"type":["array","null"]},"replyToId":{"minLength":1,"type":["string","null"]},"sharingEnabled":{"type":["boolean","null"]},"status":{"minLength":1,"type":["string","null"]},"text":{"minLength":1,"type":["string","null"]},"translation":{"additionalProperties":false,"properties":{"text":{"minLength":1,"type":["string","null"]}},"required":["text"],"type":"object"}},"required":["id","text","extracted","postId","parentId","replyToId","createdAt","author","status","isCovered","isEdited","sharingEnabled","isByPostAuthor","isPinned","pinnedPosition","isLikedByPostAuthor","ai","ranking","keywords","previewUsers","metrics","replies","translation","likedByCoauthors","media"],"type":"object"},"InstagramCommentSettings":{"additionalProperties":false,"properties":{"enabled":{"type":["boolean","null"]},"hasMore":{"type":["boolean","null"]},"likesEnabled":{"type":["boolean","null"]},"maxVisiblePreviewComments":{"type":["integer","null"]},"preview":{"items":{"$ref":"#/components/schemas/InstagramCommentReference"},"type":["array","null"]},"threadingEnabled":{"type":["boolean","null"]}},"required":["hasMore","maxVisiblePreviewComments","likesEnabled","threadingEnabled","enabled","preview"],"type":"object"},"InstagramCoordinates":{"additionalProperties":false,"properties":{"latitude":{"type":["number","null"]},"longitude":{"type":["number","null"]}},"required":["latitude","longitude"],"type":"object"},"InstagramCrop":{"additionalProperties":false,"properties":{"bottom":{"type":["number","null"]},"left":{"type":["number","null"]},"right":{"type":["number","null"]},"top":{"type":["number","null"]}},"required":["left","right","top","bottom"],"type":"object"},"InstagramDASH":{"additionalProperties":false,"properties":{"manifest":{"minLength":1,"type":["string","null"]},"qualityCount":{"type":["integer","null"]},"variants":{"items":{"$ref":"#/components/schemas/InstagramStreamVariant"},"type":["array","null"]}},"required":["manifest","variants","qualityCount"],"type":"object"},"InstagramExtracted":{"additionalProperties":false,"properties":{"emails":{"items":{"minLength":1,"type":"string"},"type":["array","null"]},"handles":{"items":{"$ref":"#/components/schemas/InstagramExtractedHandle"},"type":["array","null"]},"links":{"items":{"minLength":1,"type":"string"},"type":["array","null"]},"phones":{"items":{"minLength":1,"type":"string"},"type":["array","null"]}},"required":["emails","phones","links","handles"],"type":"object"},"InstagramExtractedHandle":{"additionalProperties":false,"properties":{"handle":{"minLength":1,"type":["string","null"]},"platform":{"minLength":1,"type":["string","null"]}},"required":["platform","handle"],"type":"object"},"InstagramHashtag":{"additionalProperties":false,"properties":{"avatar":{"anyOf":[{"$ref":"#/components/schemas/InstagramImage"},{"type":"null"}]},"bio":{"minLength":1,"type":["string","null"]},"id":{"minLength":1,"type":"string"},"isTrending":{"type":["boolean","null"]},"metrics":{"additionalProperties":false,"properties":{"posts":{"type":["integer","null"]},"views":{"type":["integer","null"]}},"required":["posts","views"],"type":"object"},"name":{"minLength":1,"type":["string","null"]},"url":{"format":"uri","minLength":1,"type":"string"}},"required":["id","name","url","bio","avatar","isTrending","metrics"],"type":"object"},"InstagramHashtagReference":{"additionalProperties":false,"properties":{"avatar":{"anyOf":[{"$ref":"#/components/schemas/InstagramImage"},{"type":"null"}]},"bio":{"minLength":1,"type":["string","null"]},"id":{"minLength":1,"type":["string","null"]},"isTrending":{"type":["boolean","null"]},"metrics":{"additionalProperties":false,"properties":{"posts":{"type":["integer","null"]},"views":{"type":["integer","null"]}},"required":["posts","views"],"type":"object"},"name":{"minLength":1,"type":["string","null"]},"url":{"format":"uri","minLength":1,"type":["string","null"]}},"required":["id","name","url","bio","avatar","isTrending","metrics"],"type":"object"},"InstagramHighlight":{"additionalProperties":false,"properties":{"author":{"anyOf":[{"$ref":"#/components/schemas/InstagramProfileReference"},{"type":"null"}]},"cover":{"anyOf":[{"$ref":"#/components/schemas/InstagramImage"},{"type":"null"}]},"createdAt":{"format":"date-time","minLength":1,"type":["string","null"]},"id":{"minLength":1,"type":"string"},"isArchived":{"type":["boolean","null"]},"isConvertedToReel":{"type":["boolean","null"]},"isInProfileGrid":{"type":["boolean","null"]},"isPinned":{"type":["boolean","null"]},"lastStoryAt":{"format":"date-time","minLength":1,"type":["string","null"]},"metrics":{"additionalProperties":false,"properties":{"stories":{"type":["integer","null"]}},"required":["stories"],"type":"object"},"stories":{"items":{"$ref":"#/components/schemas/InstagramStoryReference"},"type":["array","null"]},"title":{"minLength":1,"type":["string","null"]},"updatedAt":{"format":"date-time","minLength":1,"type":["string","null"]},"url":{"format":"uri","minLength":1,"type":"string"}},"required":["id","url","title","author","createdAt","updatedAt","lastStoryAt","isPinned","isArchived","isConvertedToReel","isInProfileGrid","cover","metrics","stories"],"type":"object"},"InstagramHighlightReference":{"additionalProperties":false,"properties":{"id":{"minLength":1,"type":["string","null"]},"title":{"minLength":1,"type":["string","null"]}},"required":["id","title"],"type":"object"},"InstagramImage":{"additionalProperties":false,"properties":{"height":{"type":["integer","null"]},"id":{"minLength":1,"type":["string","null"]},"isDefault":{"type":["boolean","null"]},"isSpatial":{"type":["boolean","null"]},"thumbnail":{"anyOf":[{"$ref":"#/components/schemas/InstagramImage"},{"type":"null"}]},"type":{"minLength":1,"type":["string","null"]},"url":{"format":"uri","minLength":1,"type":["string","null"]},"variants":{"items":{"$ref":"#/components/schemas/InstagramImage"},"type":["array","null"]},"width":{"type":["integer","null"]}},"required":["thumbnail","id","type","url","width","height","isDefault","isSpatial","variants"],"type":"object"},"InstagramLocation":{"additionalProperties":false,"properties":{"address":{"$ref":"#/components/schemas/InstagramLocationAddress"},"category":{"minLength":1,"type":["string","null"]},"coordinates":{"$ref":"#/components/schemas/InstagramCoordinates"},"external":{"additionalProperties":false,"properties":{"id":{"minLength":1,"type":["string","null"]},"source":{"minLength":1,"type":["string","null"]}},"required":["id","source"],"type":"object"},"hours":{"anyOf":[{"$ref":"#/components/schemas/InstagramLocationHours"},{"type":"null"}]},"id":{"minLength":1,"type":"string"},"name":{"minLength":1,"type":["string","null"]},"phone":{"minLength":1,"type":["string","null"]},"searchContext":{"additionalProperties":false,"properties":{"subtitle":{"minLength":1,"type":["string","null"]},"title":{"minLength":1,"type":["string","null"]}},"required":["title","subtitle"],"type":"object"},"shortName":{"minLength":1,"type":["string","null"]},"url":{"format":"uri","minLength":1,"type":"string"},"website":{"minLength":1,"type":["string","null"]}},"required":["id","name","shortName","category","url","phone","website","address","coordinates","external","searchContext","hours"],"type":"object"},"InstagramLocationAddress":{"additionalProperties":false,"properties":{"city":{"minLength":1,"type":["string","null"]},"countryCode":{"minLength":1,"type":["string","null"]},"postalCode":{"minLength":1,"type":["string","null"]},"region":{"minLength":1,"type":["string","null"]},"street":{"minLength":1,"type":["string","null"]}},"required":["street","city","postalCode","region","countryCode"],"type":"object"},"InstagramLocationHours":{"additionalProperties":false,"properties":{"currentStatus":{"minLength":1,"type":["string","null"]},"isOpen":{"type":["boolean","null"]},"schedule":{"items":{},"type":["array","null"]},"status":{"minLength":1,"type":["string","null"]},"today":{"minLength":1,"type":["string","null"]}},"required":["status","currentStatus","today","isOpen","schedule"],"type":"object"},"InstagramLocationReference":{"additionalProperties":false,"properties":{"address":{"$ref":"#/components/schemas/InstagramLocationAddress"},"category":{"minLength":1,"type":["string","null"]},"coordinates":{"$ref":"#/components/schemas/InstagramCoordinates"},"external":{"additionalProperties":false,"properties":{"id":{"minLength":1,"type":["string","null"]},"source":{"minLength":1,"type":["string","null"]}},"required":["id","source"],"type":"object"},"hours":{"anyOf":[{"$ref":"#/components/schemas/InstagramLocationHours"},{"type":"null"}]},"id":{"minLength":1,"type":["string","null"]},"name":{"minLength":1,"type":["string","null"]},"phone":{"minLength":1,"type":["string","null"]},"searchContext":{"additionalProperties":false,"properties":{"subtitle":{"minLength":1,"type":["string","null"]},"title":{"minLength":1,"type":["string","null"]}},"required":["title","subtitle"],"type":"object"},"shortName":{"minLength":1,"type":["string","null"]},"url":{"format":"uri","minLength":1,"type":["string","null"]},"website":{"minLength":1,"type":["string","null"]}},"required":["id","name","shortName","category","url","phone","website","address","coordinates","external","searchContext","hours"],"type":"object"},"InstagramMedia":{"additionalProperties":false,"properties":{"altText":{"minLength":1,"type":["string","null"]},"audio":{"anyOf":[{"$ref":"#/components/schemas/InstagramAudioReference"},{"type":"null"}]},"bitrate":{"type":["integer","null"]},"commercialityStatus":{"minLength":1,"type":["string","null"]},"createdAt":{"format":"date-time","minLength":1,"type":["string","null"]},"crops":{"additionalProperties":false,"properties":{"feedPreview":{"$ref":"#/components/schemas/InstagramCrop"},"fourByThree":{"$ref":"#/components/schemas/InstagramCrop"},"square":{"$ref":"#/components/schemas/InstagramCrop"}},"required":["fourByThree","square","feedPreview"],"type":"object"},"duration":{"type":["number","null"]},"firstFrame":{"anyOf":[{"$ref":"#/components/schemas/InstagramImage"},{"type":"null"}]},"hasAudio":{"type":["boolean","null"]},"height":{"type":["integer","null"]},"id":{"minLength":1,"type":["string","null"]},"originalHeight":{"type":["integer","null"]},"originalWidth":{"type":["integer","null"]},"parentId":{"minLength":1,"type":["string","null"]},"productTags":{"items":{"$ref":"#/components/schemas/InstagramProductTag"},"type":["array","null"]},"scrubber":{"anyOf":[{"$ref":"#/components/schemas/InstagramScrubber"},{"type":"null"}]},"streaming":{"anyOf":[{"$ref":"#/components/schemas/InstagramStreaming"},{"type":"null"}]},"subtitles":{"anyOf":[{"$ref":"#/components/schemas/InstagramSubtitles"},{"type":"null"}]},"taggedUsers":{"items":{"$ref":"#/components/schemas/InstagramUserTag"},"type":["array","null"]},"thumbnail":{"anyOf":[{"$ref":"#/components/schemas/InstagramImage"},{"type":"null"}]},"type":{"minLength":1,"type":["string","null"]},"url":{"format":"uri","minLength":1,"type":["string","null"]},"variants":{"items":{"$ref":"#/components/schemas/InstagramMediaVariant"},"type":["array","null"]},"width":{"type":["integer","null"]}},"required":["id","type","parentId","createdAt","url","width","height","originalWidth","originalHeight","bitrate","hasAudio","altText","commercialityStatus","duration","variants","thumbnail","firstFrame","scrubber","streaming","subtitles","audio","taggedUsers","productTags","crops"],"type":"object"},"InstagramMediaPreview":{"additionalProperties":false,"properties":{"fbid":{"minLength":1,"type":["string","null"]},"id":{"minLength":1,"type":["string","null"]},"thumbnail":{"anyOf":[{"$ref":"#/components/schemas/InstagramImage"},{"type":"null"}]}},"required":["id","fbid","thumbnail"],"type":"object"},"InstagramMediaVariant":{"additionalProperties":false,"properties":{"bitrate":{"type":["integer","null"]},"height":{"type":["integer","null"]},"id":{"minLength":1,"type":["string","null"]},"isSpatial":{"type":["boolean","null"]},"type":{"minLength":1,"type":["string","null"]},"url":{"format":"uri","minLength":1,"type":["string","null"]},"width":{"type":["integer","null"]}},"required":["id","type","url","width","height","bitrate","isSpatial"],"type":"object"},"InstagramMusic":{"additionalProperties":false,"properties":{"artist":{"anyOf":[{"$ref":"#/components/schemas/InstagramProfileReference"},{"type":"null"}]},"artistId":{"minLength":1,"type":["string","null"]},"artistName":{"minLength":1,"type":["string","null"]},"artwork":{"anyOf":[{"$ref":"#/components/schemas/InstagramImage"},{"type":"null"}]},"clusterId":{"minLength":1,"type":["string","null"]},"compositionStartTime":{"type":["number","null"]},"createdAt":{"format":"date-time","minLength":1,"type":["string","null"]},"duration":{"type":["number","null"]},"fastStartUrl":{"format":"uri","minLength":1,"type":["string","null"]},"filters":{"items":{},"type":["array","null"]},"hasLyrics":{"type":["boolean","null"]},"highlightStartTimes":{"items":{"type":"number"},"type":["array","null"]},"id":{"minLength":1,"type":"string"},"isAutomaticallyAttributed":{"type":["boolean","null"]},"isCrosspostedFromFacebook":{"type":["boolean","null"]},"isExplicit":{"type":["boolean","null"]},"isTrending":{"type":["boolean","null"]},"metrics":{"$ref":"#/components/schemas/InstagramAudioMetrics"},"monetizationType":{"minLength":1,"type":["string","null"]},"musicId":{"minLength":1,"type":["string","null"]},"originalPostId":{"minLength":1,"type":["string","null"]},"overlapDuration":{"type":["number","null"]},"parts":{"items":{"$ref":"#/components/schemas/InstagramAudioPart"},"type":["array","null"]},"posts":{"items":{"$ref":"#/components/schemas/InstagramPostReference"},"type":["array","null"]},"previewUrl":{"format":"uri","minLength":1,"type":["string","null"]},"spotify":{"additionalProperties":false,"properties":{"id":{"minLength":1,"type":["string","null"]},"url":{"format":"uri","minLength":1,"type":["string","null"]}},"required":["id","url"],"type":"object"},"startTime":{"type":["number","null"]},"streaming":{"anyOf":[{"$ref":"#/components/schemas/InstagramStreaming"},{"type":"null"}]},"subtype":{"minLength":1,"type":["string","null"]},"title":{"minLength":1,"type":["string","null"]},"type":{"minLength":1,"type":["string","null"]},"url":{"format":"uri","minLength":1,"type":["string","null"]},"usageLabel":{"minLength":1,"type":["string","null"]}},"required":["id","type","musicId","artistId","clusterId","title","artistName","artist","isExplicit","hasLyrics","isTrending","subtype","isAutomaticallyAttributed","isCrosspostedFromFacebook","monetizationType","duration","startTime","overlapDuration","compositionStartTime","createdAt","originalPostId","url","fastStartUrl","previewUrl","artwork","streaming","highlightStartTimes","filters","metrics","spotify","parts","usageLabel","posts"],"type":"object"},"InstagramMusicStream":{"additionalProperties":false,"properties":{"id":{"minLength":1,"type":"string"},"media":{"items":{"$ref":"#/components/schemas/InstagramMedia"},"type":"array"},"metrics":{"$ref":"#/components/schemas/InstagramMusicStreamMetrics"},"type":{"minLength":1,"type":["string","null"]}},"required":["id","type","media","metrics"],"type":"object"},"InstagramMusicStreamMetrics":{"additionalProperties":false,"properties":{"plays":{"type":["integer","null"]}},"required":["plays"],"type":"object"},"InstagramNote":{"additionalProperties":false,"properties":{"author":{"anyOf":[{"$ref":"#/components/schemas/InstagramProfileReference"},{"type":"null"}]},"createdAt":{"format":"date-time","minLength":1,"type":["string","null"]},"id":{"minLength":1,"type":["string","null"]},"text":{"minLength":1,"type":["string","null"]}},"required":["id","text","createdAt","author"],"type":"object"},"InstagramOEmbed":{"additionalProperties":false,"properties":{"author":{"anyOf":[{"$ref":"#/components/schemas/InstagramProfileReference"},{"type":"null"}]},"height":{"type":["integer","null"]},"html":{"minLength":1,"type":["string","null"]},"postId":{"minLength":1,"type":["string","null"]},"provider":{"additionalProperties":false,"properties":{"name":{"minLength":1,"type":["string","null"]},"url":{"format":"uri","minLength":1,"type":["string","null"]}},"required":["name","url"],"type":"object"},"thumbnail":{"anyOf":[{"$ref":"#/components/schemas/InstagramImage"},{"type":"null"}]},"title":{"minLength":1,"type":["string","null"]},"type":{"minLength":1,"type":["string","null"]},"width":{"type":["integer","null"]}},"required":["postId","type","title","html","width","height","author","provider","thumbnail"],"type":"object"},"InstagramPageMetadata":{"additionalProperties":false,"properties":{"collection":{"anyOf":[{"$ref":"#/components/schemas/InstagramStoryCollection"},{"type":"null"}]},"hasMore":{"type":["boolean","null"]},"hasMoreAfter":{"type":["boolean","null"]},"hasMoreBefore":{"type":["boolean","null"]},"likesEnabled":{"type":["boolean","null"]},"metrics":{"additionalProperties":false,"properties":{"comments":{"type":["integer","null"]},"likes":{"type":["integer","null"]},"replies":{"type":["integer","null"]}},"required":["likes","comments","replies"],"type":"object"},"parent":{"anyOf":[{"$ref":"#/components/schemas/InstagramCommentReference"},{"type":"null"}]},"threadingEnabled":{"type":["boolean","null"]},"track":{"anyOf":[{"$ref":"#/components/schemas/InstagramAudioReference"},{"type":"null"}]}},"required":["metrics","threadingEnabled","likesEnabled","hasMore","hasMoreBefore","hasMoreAfter","parent","collection","track"],"type":"object"},"InstagramPartialData":{"additionalProperties":false,"properties":{"errors":{"items":{"$ref":"#/components/schemas/InstagramPartialError"},"type":["array","null"]}},"required":["errors"],"type":"object"},"InstagramPartialError":{"additionalProperties":false,"properties":{"message":{"minLength":1,"type":["string","null"]},"path":{"items":{"minLength":1,"type":"string"},"type":["array","null"]}},"required":["message","path"],"type":"object"},"InstagramPosition":{"additionalProperties":false,"properties":{"x":{"type":["number","null"]},"y":{"type":["number","null"]}},"required":["x","y"],"type":"object"},"InstagramPost":{"additionalProperties":false,"properties":{"ai":{"additionalProperties":false,"properties":{"detectionMethod":{"minLength":1,"type":["string","null"]},"label":{"additionalProperties":false,"properties":{"detectionMethod":{"minLength":1,"type":["string","null"]},"isSelfDisclosed":{"type":["boolean","null"]},"subtitle":{"minLength":1,"type":["string","null"]},"text":{"minLength":1,"type":["string","null"]}},"required":["text","subtitle","detectionMethod","isSelfDisclosed"],"type":"object"}},"required":["detectionMethod","label"],"type":"object"},"attribution":{"additionalProperties":false,"properties":{"originalPost":{"anyOf":[{"$ref":"#/components/schemas/InstagramPostReference"},{"type":"null"}]}},"required":["originalPost"],"type":"object"},"author":{"anyOf":[{"$ref":"#/components/schemas/InstagramProfileReference"},{"type":"null"}]},"caption":{"anyOf":[{"$ref":"#/components/schemas/InstagramCaptionReference"},{"type":"null"}]},"carousel":{"additionalProperties":false,"properties":{"itemCount":{"type":["integer","null"]},"pendingItemCount":{"type":["integer","null"]},"previousSubmitters":{"items":{"$ref":"#/components/schemas/InstagramProfileReference"},"type":["array","null"]},"submissionState":{"minLength":1,"type":["string","null"]}},"required":["itemCount","pendingItemCount","submissionState","previousSubmitters"],"type":"object"},"code":{"minLength":1,"type":["string","null"]},"collaborators":{"items":{"$ref":"#/components/schemas/InstagramProfileReference"},"type":["array","null"]},"comments":{"$ref":"#/components/schemas/InstagramCommentSettings"},"createdAt":{"format":"date-time","minLength":1,"type":"string"},"crossposting":{"additionalProperties":false,"properties":{"isFeedbackAggregated":{"type":["boolean","null"]},"isSharedToFacebook":{"type":["boolean","null"]}},"required":["isSharedToFacebook","isFeedbackAggregated"],"type":"object"},"extracted":{"$ref":"#/components/schemas/InstagramExtracted"},"fbid":{"minLength":1,"type":["string","null"]},"hasDelayedMetadata":{"type":["boolean","null"]},"hasTaggedUsers":{"type":["boolean","null"]},"hasVisualReplies":{"type":["boolean","null"]},"id":{"minLength":1,"type":"string"},"invitedCollaborators":{"items":{"$ref":"#/components/schemas/InstagramProfileReference"},"type":["array","null"]},"isEarlyAccess":{"type":["boolean","null"]},"isFanClubPromo":{"type":["boolean","null"]},"isOpenToPublicSubmission":{"type":["boolean","null"]},"isPaidPartnership":{"type":["boolean","null"]},"isPublicChatWelcomeVideo":{"type":["boolean","null"]},"language":{"minLength":1,"type":["string","null"]},"likeAndViewCountsHidden":{"type":["boolean","null"]},"location":{"anyOf":[{"$ref":"#/components/schemas/InstagramLocationReference"},{"type":"null"}]},"media":{"items":{"$ref":"#/components/schemas/InstagramMedia"},"type":"array"},"metrics":{"$ref":"#/components/schemas/InstagramPostMetrics"},"notes":{"items":{"$ref":"#/components/schemas/InstagramNote"},"type":["array","null"]},"pinning":{"additionalProperties":false,"properties":{"profileUserIds":{"items":{"minLength":1,"type":"string"},"type":["array","null"]},"reelsUserIds":{"items":{"minLength":1,"type":"string"},"type":["array","null"]}},"required":["profileUserIds","reelsUserIds"],"type":"object"},"productTags":{"items":{"$ref":"#/components/schemas/InstagramProductTag"},"type":["array","null"]},"remix":{"additionalProperties":false,"properties":{"allowed":{"type":["boolean","null"]},"carouselRemixesAllowed":{"type":["boolean","null"]},"crosspostingAllowed":{"type":["boolean","null"]},"hasBeenRemixed":{"type":["boolean","null"]},"isRequestingRemixes":{"type":["boolean","null"]}},"required":["allowed","carouselRemixesAllowed","hasBeenRemixed","isRequestingRemixes","crosspostingAllowed"],"type":"object"},"reuse":{"additionalProperties":false,"properties":{"allowed":{"type":["boolean","null"]},"cutoutStickersAllowed":{"type":["boolean","null"]}},"required":["allowed","cutoutStickersAllowed"],"type":"object"},"shareCountHidden":{"type":["boolean","null"]},"sharingEnabled":{"type":["boolean","null"]},"taggedUsers":{"items":{"$ref":"#/components/schemas/InstagramUserTag"},"type":["array","null"]},"template":{"anyOf":[{"$ref":"#/components/schemas/InstagramTemplateInfo"},{"type":"null"}]},"text":{"minLength":1,"type":["string","null"]},"title":{"minLength":1,"type":["string","null"]},"type":{"minLength":1,"type":["string","null"]},"url":{"format":"uri","minLength":1,"type":"string"}},"required":["id","code","fbid","type","url","title","text","extracted","createdAt","author","caption","media","metrics","comments","taggedUsers","productTags","collaborators","invitedCollaborators","location","isPaidPartnership","isEarlyAccess","likeAndViewCountsHidden","shareCountHidden","hasVisualReplies","hasDelayedMetadata","language","hasTaggedUsers","isOpenToPublicSubmission","sharingEnabled","isFanClubPromo","isPublicChatWelcomeVideo","reuse","remix","pinning","carousel","ai","notes","crossposting","attribution","template"],"type":"object"},"InstagramPostInsight":{"additionalProperties":false,"properties":{"authorId":{"minLength":1,"type":["string","null"]},"createdAt":{"format":"date-time","minLength":1,"type":["string","null"]},"facebook":{"additionalProperties":false,"properties":{"accountId":{"minLength":1,"type":["string","null"]},"actorId":{"minLength":1,"type":["string","null"]}},"required":["actorId","accountId"],"type":"object"},"fbid":{"minLength":1,"type":["string","null"]},"hasProductTags":{"type":["boolean","null"]},"image":{"additionalProperties":false,"properties":{"height":{"type":["integer","null"]},"width":{"type":["integer","null"]}},"required":["width","height"],"type":"object"},"metrics":{"additionalProperties":false,"properties":{"comments":{"type":["integer","null"]},"likes":{"type":["integer","null"]},"saves":{"type":["integer","null"]},"shopping":{"additionalProperties":false,"properties":{"productClicks":{"items":{},"type":["array","null"]},"productOutboundClicks":{"items":{},"type":["array","null"]}},"required":["productClicks","productOutboundClicks"],"type":"object"},"shoppingOutboundClicks":{"type":["integer","null"]},"shoppingProductClicks":{"type":["integer","null"]}},"required":["likes","comments","saves","shoppingOutboundClicks","shoppingProductClicks","shopping"],"type":"object"},"organicPostId":{"minLength":1,"type":["string","null"]},"postId":{"minLength":1,"type":["string","null"]},"thumbnail":{"anyOf":[{"$ref":"#/components/schemas/InstagramImage"},{"type":"null"}]},"type":{"minLength":1,"type":["string","null"]}},"required":["postId","fbid","authorId","organicPostId","createdAt","type","hasProductTags","thumbnail","image","metrics","facebook"],"type":"object"},"InstagramPostMetrics":{"additionalProperties":false,"properties":{"comments":{"type":["integer","null"]},"facebook":{"additionalProperties":false,"properties":{"comments":{"type":["integer","null"]},"likes":{"type":["integer","null"]},"plays":{"type":["integer","null"]}},"required":["likes","plays","comments"],"type":"object"},"instagram":{"additionalProperties":false,"properties":{"plays":{"type":["integer","null"]}},"required":["plays"],"type":"object"},"likes":{"type":["integer","null"]},"plays":{"type":["integer","null"]},"premiumReactions":{"type":["integer","null"]},"reposts":{"type":["integer","null"]},"reshares":{"type":["integer","null"]},"saves":{"type":["integer","null"]},"views":{"type":["integer","null"]}},"required":["likes","comments","saves","reshares","reposts","premiumReactions","plays","views","instagram","facebook"],"type":"object"},"InstagramPostReference":{"additionalProperties":false,"properties":{"ai":{"additionalProperties":false,"properties":{"detectionMethod":{"minLength":1,"type":["string","null"]},"label":{"additionalProperties":false,"properties":{"detectionMethod":{"minLength":1,"type":["string","null"]},"isSelfDisclosed":{"type":["boolean","null"]},"subtitle":{"minLength":1,"type":["string","null"]},"text":{"minLength":1,"type":["string","null"]}},"required":["text","subtitle","detectionMethod","isSelfDisclosed"],"type":"object"}},"required":["detectionMethod","label"],"type":"object"},"attribution":{"additionalProperties":false,"properties":{"originalPost":{"anyOf":[{"$ref":"#/components/schemas/InstagramPostReference"},{"type":"null"}]}},"required":["originalPost"],"type":"object"},"author":{"anyOf":[{"$ref":"#/components/schemas/InstagramProfileReference"},{"type":"null"}]},"caption":{"anyOf":[{"$ref":"#/components/schemas/InstagramCaptionReference"},{"type":"null"}]},"carousel":{"additionalProperties":false,"properties":{"itemCount":{"type":["integer","null"]},"pendingItemCount":{"type":["integer","null"]},"previousSubmitters":{"items":{"$ref":"#/components/schemas/InstagramProfileReference"},"type":["array","null"]},"submissionState":{"minLength":1,"type":["string","null"]}},"required":["itemCount","pendingItemCount","submissionState","previousSubmitters"],"type":"object"},"code":{"minLength":1,"type":["string","null"]},"collaborators":{"items":{"$ref":"#/components/schemas/InstagramProfileReference"},"type":["array","null"]},"comments":{"$ref":"#/components/schemas/InstagramCommentSettings"},"createdAt":{"format":"date-time","minLength":1,"type":["string","null"]},"crossposting":{"additionalProperties":false,"properties":{"isFeedbackAggregated":{"type":["boolean","null"]},"isSharedToFacebook":{"type":["boolean","null"]}},"required":["isSharedToFacebook","isFeedbackAggregated"],"type":"object"},"extracted":{"$ref":"#/components/schemas/InstagramExtracted"},"fbid":{"minLength":1,"type":["string","null"]},"hasDelayedMetadata":{"type":["boolean","null"]},"hasTaggedUsers":{"type":["boolean","null"]},"hasVisualReplies":{"type":["boolean","null"]},"id":{"minLength":1,"type":["string","null"]},"invitedCollaborators":{"items":{"$ref":"#/components/schemas/InstagramProfileReference"},"type":["array","null"]},"isEarlyAccess":{"type":["boolean","null"]},"isFanClubPromo":{"type":["boolean","null"]},"isOpenToPublicSubmission":{"type":["boolean","null"]},"isPaidPartnership":{"type":["boolean","null"]},"isPublicChatWelcomeVideo":{"type":["boolean","null"]},"language":{"minLength":1,"type":["string","null"]},"likeAndViewCountsHidden":{"type":["boolean","null"]},"location":{"anyOf":[{"$ref":"#/components/schemas/InstagramLocationReference"},{"type":"null"}]},"media":{"items":{"$ref":"#/components/schemas/InstagramMedia"},"type":["array","null"]},"metrics":{"$ref":"#/components/schemas/InstagramPostMetrics"},"notes":{"items":{"$ref":"#/components/schemas/InstagramNote"},"type":["array","null"]},"pinning":{"additionalProperties":false,"properties":{"profileUserIds":{"items":{"minLength":1,"type":"string"},"type":["array","null"]},"reelsUserIds":{"items":{"minLength":1,"type":"string"},"type":["array","null"]}},"required":["profileUserIds","reelsUserIds"],"type":"object"},"productTags":{"items":{"$ref":"#/components/schemas/InstagramProductTag"},"type":["array","null"]},"remix":{"additionalProperties":false,"properties":{"allowed":{"type":["boolean","null"]},"carouselRemixesAllowed":{"type":["boolean","null"]},"crosspostingAllowed":{"type":["boolean","null"]},"hasBeenRemixed":{"type":["boolean","null"]},"isRequestingRemixes":{"type":["boolean","null"]}},"required":["allowed","carouselRemixesAllowed","hasBeenRemixed","isRequestingRemixes","crosspostingAllowed"],"type":"object"},"reuse":{"additionalProperties":false,"properties":{"allowed":{"type":["boolean","null"]},"cutoutStickersAllowed":{"type":["boolean","null"]}},"required":["allowed","cutoutStickersAllowed"],"type":"object"},"shareCountHidden":{"type":["boolean","null"]},"sharingEnabled":{"type":["boolean","null"]},"taggedUsers":{"items":{"$ref":"#/components/schemas/InstagramUserTag"},"type":["array","null"]},"template":{"anyOf":[{"$ref":"#/components/schemas/InstagramTemplateInfo"},{"type":"null"}]},"text":{"minLength":1,"type":["string","null"]},"title":{"minLength":1,"type":["string","null"]},"type":{"minLength":1,"type":["string","null"]},"url":{"format":"uri","minLength":1,"type":["string","null"]}},"required":["id","code","fbid","type","url","title","text","extracted","createdAt","author","caption","media","metrics","comments","taggedUsers","productTags","collaborators","invitedCollaborators","location","isPaidPartnership","isEarlyAccess","likeAndViewCountsHidden","shareCountHidden","hasVisualReplies","hasDelayedMetadata","language","hasTaggedUsers","isOpenToPublicSubmission","sharingEnabled","isFanClubPromo","isPublicChatWelcomeVideo","reuse","remix","pinning","carousel","ai","notes","crossposting","attribution","template"],"type":"object"},"InstagramPrice":{"additionalProperties":false,"properties":{"amount":{"minLength":1,"type":["string","null"]},"formatted":{"minLength":1,"type":["string","null"]},"strippedFormatted":{"minLength":1,"type":["string","null"]}},"required":["amount","formatted","strippedFormatted"],"type":"object"},"InstagramProduct":{"additionalProperties":false,"properties":{"checkout":{"additionalProperties":false,"properties":{"style":{"minLength":1,"type":["string","null"]}},"required":["style"],"type":"object"},"compoundId":{"minLength":1,"type":["string","null"]},"description":{"minLength":1,"type":["string","null"]},"hasVariants":{"type":["boolean","null"]},"id":{"minLength":1,"type":["string","null"]},"image":{"anyOf":[{"$ref":"#/components/schemas/InstagramImage"},{"type":"null"}]},"isAffiliate":{"type":["boolean","null"]},"isInStock":{"type":["boolean","null"]},"merchant":{"anyOf":[{"$ref":"#/components/schemas/InstagramProfileReference"},{"type":"null"}]},"name":{"minLength":1,"type":["string","null"]},"pricing":{"additionalProperties":false,"properties":{"current":{"$ref":"#/components/schemas/InstagramPrice"},"formatted":{"minLength":1,"type":["string","null"]},"full":{"$ref":"#/components/schemas/InstagramPrice"},"isUkEuCompliant":{"type":["boolean","null"]}},"required":["current","full","formatted","isUkEuCompliant"],"type":"object"},"retailerId":{"minLength":1,"type":["string","null"]},"reviewStatus":{"minLength":1,"type":["string","null"]},"thumbnail":{"anyOf":[{"$ref":"#/components/schemas/InstagramImage"},{"type":"null"}]},"url":{"format":"uri","minLength":1,"type":["string","null"]}},"required":["id","compoundId","retailerId","name","description","url","hasVariants","isInStock","isAffiliate","reviewStatus","merchant","image","thumbnail","pricing","checkout"],"type":"object"},"InstagramProductTag":{"additionalProperties":false,"properties":{"position":{"$ref":"#/components/schemas/InstagramPosition"},"product":{"$ref":"#/components/schemas/InstagramProduct"}},"required":["product","position"],"type":"object"},"InstagramProfile":{"additionalProperties":false,"properties":{"accountBadges":{"items":{},"type":["array","null"]},"accountType":{"anyOf":[{"$ref":"#/components/schemas/InstagramProfileAccountType"},{"type":"null"}]},"avatar":{"anyOf":[{"$ref":"#/components/schemas/InstagramImage"},{"type":"null"}]},"bio":{"minLength":1,"type":["string","null"]},"bioEntities":{"items":{},"type":["array","null"]},"bioLinks":{"items":{"$ref":"#/components/schemas/InstagramBioLink"},"type":["array","null"]},"broadcastChannels":{"$ref":"#/components/schemas/InstagramProfileBroadcastChannels"},"category":{"minLength":1,"type":["string","null"]},"categoryId":{"minLength":1,"type":["string","null"]},"contact":{"$ref":"#/components/schemas/InstagramProfileContact"},"content":{"$ref":"#/components/schemas/InstagramProfileContent"},"contentSettings":{"$ref":"#/components/schemas/InstagramProfileContentSettings"},"displayName":{"minLength":1,"type":["string","null"]},"displaySettings":{"$ref":"#/components/schemas/InstagramProfileDisplaySettings"},"externalUrl":{"format":"uri","minLength":1,"type":["string","null"]},"extracted":{"$ref":"#/components/schemas/InstagramExtracted"},"fanClub":{"$ref":"#/components/schemas/InstagramProfileFanClub"},"fbid":{"minLength":1,"type":["string","null"]},"fundraisers":{"$ref":"#/components/schemas/InstagramProfileFundraisers"},"handle":{"minLength":1,"type":"string"},"hasDigitalAvatar":{"type":["boolean","null"]},"id":{"minLength":1,"type":"string"},"isAccountTransparencyVisible":{"type":["boolean","null"]},"isBusiness":{"type":["boolean","null"]},"isFacebookOnboardedCharity":{"type":["boolean","null"]},"isMemorialized":{"type":["boolean","null"]},"isNew":{"type":["boolean","null"]},"isOpenToCollaboration":{"type":["boolean","null"]},"isPotentialBusiness":{"type":["boolean","null"]},"isPrivate":{"type":["boolean","null"]},"isUnpublished":{"type":["boolean","null"]},"isVerified":{"type":["boolean","null"]},"lastStoryAt":{"format":"date-time","minLength":1,"type":["string","null"]},"location":{"$ref":"#/components/schemas/InstagramProfileLocation"},"mediaPreviews":{"items":{"$ref":"#/components/schemas/InstagramMediaPreview"},"type":["array","null"]},"messagingFbid":{"minLength":1,"type":["string","null"]},"metrics":{"$ref":"#/components/schemas/InstagramProfileMetrics"},"pronouns":{"items":{"minLength":1,"type":"string"},"type":["array","null"]},"socialContext":{"minLength":1,"type":["string","null"]},"suggestion":{"anyOf":[{"$ref":"#/components/schemas/InstagramSuggestion"},{"type":"null"}]},"threads":{"$ref":"#/components/schemas/InstagramProfileThreads"},"upcomingEvents":{"items":{},"type":["array","null"]},"url":{"format":"uri","minLength":1,"type":"string"}},"required":["suggestion","mediaPreviews","id","handle","displayName","bio","extracted","url","externalUrl","avatar","fbid","messagingFbid","isPrivate","isVerified","isBusiness","isPotentialBusiness","isUnpublished","isMemorialized","isNew","isOpenToCollaboration","isFacebookOnboardedCharity","hasDigitalAvatar","isAccountTransparencyVisible","category","categoryId","accountType","socialContext","lastStoryAt","pronouns","accountBadges","bioEntities","bioLinks","upcomingEvents","metrics","contact","location","fanClub","content","contentSettings","displaySettings","threads","broadcastChannels","fundraisers"],"type":"object"},"InstagramProfileAbout":{"additionalProperties":false,"properties":{"country":{"minLength":1,"type":["string","null"]},"handle":{"minLength":1,"type":["string","null"]},"isVerified":{"type":["boolean","null"]},"joinedAt":{"description":"Account creation month. Day and time are unavailable.","pattern":"^\\d{4}-\\d{2}$","type":["string","null"]},"metrics":{"additionalProperties":false,"properties":{"handleChanges":{"type":["integer","null"]}},"required":["handleChanges"],"type":"object"}},"required":["handle","country","joinedAt","isVerified","metrics"],"type":"object"},"InstagramProfileAccountType":{"oneOf":[{"enum":["personal","business","creator"],"type":"string"},{"type":"integer"}]},"InstagramProfileAddress":{"additionalProperties":false,"properties":{"city":{"minLength":1,"type":["string","null"]},"cityId":{"minLength":1,"type":["string","null"]},"postalCode":{"minLength":1,"type":["string","null"]},"street":{"minLength":1,"type":["string","null"]}},"required":["street","city","cityId","postalCode"],"type":"object"},"InstagramProfileBroadcastChannel":{"additionalProperties":false,"properties":{"avatar":{"anyOf":[{"$ref":"#/components/schemas/InstagramImage"},{"type":"null"}]},"cover":{"anyOf":[{"$ref":"#/components/schemas/InstagramImage"},{"type":"null"}]},"creator":{"additionalProperties":false,"properties":{"handle":{"minLength":1,"type":["string","null"]},"id":{"minLength":1,"type":["string","null"]},"isVerified":{"type":["boolean","null"]}},"required":["id","handle","isVerified"],"type":"object"},"id":{"minLength":1,"type":["string","null"]},"metrics":{"additionalProperties":false,"properties":{"members":{"type":["integer","null"]}},"required":["members"],"type":"object"},"title":{"minLength":1,"type":["string","null"]},"url":{"format":"uri","minLength":1,"type":["string","null"]}},"required":["id","title","url","avatar","cover","creator","metrics"],"type":"object"},"InstagramProfileBroadcastChannels":{"additionalProperties":false,"properties":{"hasPublicChannels":{"type":["boolean","null"]},"isCreator":{"type":["boolean","null"]},"pinned":{"items":{"$ref":"#/components/schemas/InstagramProfileBroadcastChannel"},"type":["array","null"]}},"required":["isCreator","hasPublicChannels","pinned"],"type":"object"},"InstagramProfileContact":{"additionalProperties":false,"properties":{"contactPhone":{"minLength":1,"type":["string","null"]},"email":{"minLength":1,"type":["string","null"]},"method":{"minLength":1,"type":["string","null"]},"phone":{"minLength":1,"type":["string","null"]},"phoneCountryCode":{"minLength":1,"type":["string","null"]}},"required":["email","phone","phoneCountryCode","contactPhone","method"],"type":"object"},"InstagramProfileContent":{"additionalProperties":false,"properties":{"hasGuides":{"type":["boolean","null"]},"hasHighlights":{"type":["boolean","null"]},"hasLongformMedia":{"type":["boolean","null"]},"hasMusic":{"type":["boolean","null"]},"hasVideos":{"type":["boolean","null"]},"hasVisibleNotes":{"type":["boolean","null"]}},"required":["hasHighlights","hasLongformMedia","hasVideos","hasMusic","hasGuides","hasVisibleNotes"],"type":"object"},"InstagramProfileContentSettings":{"additionalProperties":false,"properties":{"highlightResharingEnabled":{"type":["boolean","null"]},"postRemixingEnabled":{"type":["boolean","null"]},"postResharingEnabled":{"type":["boolean","null"]},"reelRemixingEnabled":{"type":["boolean","null"]}},"required":["postResharingEnabled","highlightResharingEnabled","postRemixingEnabled","reelRemixingEnabled"],"type":"object"},"InstagramProfileDisplaySettings":{"additionalProperties":false,"properties":{"showCategory":{"type":["boolean","null"]},"showPublicContacts":{"type":["boolean","null"]}},"required":["showCategory","showPublicContacts"],"type":"object"},"InstagramProfileFanClub":{"additionalProperties":false,"properties":{"hasExclusiveFeedContent":{"type":["boolean","null"]},"id":{"minLength":1,"type":["string","null"]},"largestPublicBroadcastChannelId":{"minLength":1,"type":["string","null"]},"metrics":{"additionalProperties":false,"properties":{"subscribers":{"type":["integer","null"]}},"required":["subscribers"],"type":"object"},"name":{"minLength":1,"type":["string","null"]}},"required":["id","name","largestPublicBroadcastChannelId","hasExclusiveFeedContent","metrics"],"type":"object"},"InstagramProfileFundraisers":{"additionalProperties":false,"properties":{"items":{"items":{},"type":["array","null"]},"metrics":{"additionalProperties":false,"properties":{"active":{"type":["integer","null"]}},"required":["active"],"type":"object"}},"required":["metrics","items"],"type":"object"},"InstagramProfileLocation":{"additionalProperties":false,"properties":{"address":{"$ref":"#/components/schemas/InstagramProfileAddress"},"id":{"minLength":1,"type":["string","null"]}},"required":["id","address"],"type":"object"},"InstagramProfileMetrics":{"additionalProperties":false,"properties":{"arEffects":{"type":["integer","null"]},"followers":{"type":["integer","null"]},"following":{"type":["integer","null"]},"posts":{"type":["integer","null"]}},"required":["followers","following","posts","arEffects"],"type":"object"},"InstagramProfileReference":{"additionalProperties":false,"properties":{"accountBadges":{"items":{},"type":["array","null"]},"accountType":{"anyOf":[{"$ref":"#/components/schemas/InstagramProfileAccountType"},{"type":"null"}]},"avatar":{"anyOf":[{"$ref":"#/components/schemas/InstagramImage"},{"type":"null"}]},"bio":{"minLength":1,"type":["string","null"]},"bioEntities":{"items":{},"type":["array","null"]},"bioLinks":{"items":{"$ref":"#/components/schemas/InstagramBioLink"},"type":["array","null"]},"broadcastChannels":{"$ref":"#/components/schemas/InstagramProfileBroadcastChannels"},"category":{"minLength":1,"type":["string","null"]},"categoryId":{"minLength":1,"type":["string","null"]},"contact":{"$ref":"#/components/schemas/InstagramProfileContact"},"content":{"$ref":"#/components/schemas/InstagramProfileContent"},"contentSettings":{"$ref":"#/components/schemas/InstagramProfileContentSettings"},"displayName":{"minLength":1,"type":["string","null"]},"displaySettings":{"$ref":"#/components/schemas/InstagramProfileDisplaySettings"},"externalUrl":{"format":"uri","minLength":1,"type":["string","null"]},"extracted":{"$ref":"#/components/schemas/InstagramExtracted"},"fanClub":{"$ref":"#/components/schemas/InstagramProfileFanClub"},"fbid":{"minLength":1,"type":["string","null"]},"fundraisers":{"$ref":"#/components/schemas/InstagramProfileFundraisers"},"handle":{"minLength":1,"type":["string","null"]},"hasDigitalAvatar":{"type":["boolean","null"]},"id":{"minLength":1,"type":["string","null"]},"isAccountTransparencyVisible":{"type":["boolean","null"]},"isBusiness":{"type":["boolean","null"]},"isFacebookOnboardedCharity":{"type":["boolean","null"]},"isMemorialized":{"type":["boolean","null"]},"isNew":{"type":["boolean","null"]},"isOpenToCollaboration":{"type":["boolean","null"]},"isPotentialBusiness":{"type":["boolean","null"]},"isPrivate":{"type":["boolean","null"]},"isUnpublished":{"type":["boolean","null"]},"isVerified":{"type":["boolean","null"]},"lastStoryAt":{"format":"date-time","minLength":1,"type":["string","null"]},"location":{"$ref":"#/components/schemas/InstagramProfileLocation"},"mediaPreviews":{"items":{"$ref":"#/components/schemas/InstagramMediaPreview"},"type":["array","null"]},"messagingFbid":{"minLength":1,"type":["string","null"]},"metrics":{"$ref":"#/components/schemas/InstagramProfileMetrics"},"pronouns":{"items":{"minLength":1,"type":"string"},"type":["array","null"]},"socialContext":{"minLength":1,"type":["string","null"]},"suggestion":{"anyOf":[{"$ref":"#/components/schemas/InstagramSuggestion"},{"type":"null"}]},"threads":{"$ref":"#/components/schemas/InstagramProfileThreads"},"upcomingEvents":{"items":{},"type":["array","null"]},"url":{"format":"uri","minLength":1,"type":["string","null"]}},"required":["suggestion","mediaPreviews","id","handle","displayName","bio","extracted","url","externalUrl","avatar","fbid","messagingFbid","isPrivate","isVerified","isBusiness","isPotentialBusiness","isUnpublished","isMemorialized","isNew","isOpenToCollaboration","isFacebookOnboardedCharity","hasDigitalAvatar","isAccountTransparencyVisible","category","categoryId","accountType","socialContext","lastStoryAt","pronouns","accountBadges","bioEntities","bioLinks","upcomingEvents","metrics","contact","location","fanClub","content","contentSettings","displaySettings","threads","broadcastChannels","fundraisers"],"type":"object"},"InstagramProfileSummary":{"$ref":"#/components/schemas/InstagramProfile"},"InstagramProfileThreads":{"additionalProperties":false,"properties":{"handle":{"minLength":1,"type":["string","null"]},"isActive":{"type":["boolean","null"]},"joinerLabel":{"minLength":1,"type":["string","null"]},"url":{"format":"uri","minLength":1,"type":["string","null"]}},"required":["isActive","handle","url","joinerLabel"],"type":"object"},"InstagramScrubber":{"additionalProperties":false,"properties":{"duration":{"type":["number","null"]},"height":{"type":["integer","null"]},"maxThumbnailsPerSprite":{"type":["integer","null"]},"thumbnailDuration":{"type":["number","null"]},"thumbnailHeight":{"type":["integer","null"]},"thumbnailWidth":{"type":["integer","null"]},"thumbnailsPerRow":{"type":["integer","null"]},"thumbnailsPerSprite":{"type":["integer","null"]},"urls":{"items":{"minLength":1,"type":"string"},"type":["array","null"]},"width":{"type":["integer","null"]}},"required":["urls","width","height","thumbnailWidth","thumbnailHeight","thumbnailsPerRow","thumbnailsPerSprite","maxThumbnailsPerSprite","thumbnailDuration","duration"],"type":"object"},"InstagramSearchResult":{"$ref":"#/components/schemas/InstagramPost"},"InstagramSticker":{"additionalProperties":false,"properties":{"audio":{"anyOf":[{"$ref":"#/components/schemas/InstagramAudioReference"},{"type":"null"}]},"endTime":{"type":["number","null"]},"hashtag":{"anyOf":[{"$ref":"#/components/schemas/InstagramHashtagReference"},{"type":"null"}]},"id":{"minLength":1,"type":["string","null"]},"isHidden":{"type":["boolean","null"]},"isPinned":{"type":["boolean","null"]},"position":{"additionalProperties":false,"properties":{"height":{"type":["number","null"]},"rotation":{"type":["number","null"]},"width":{"type":["number","null"]},"x":{"type":["number","null"]},"y":{"type":["number","null"]},"z":{"type":["number","null"]}},"required":["x","y","z","width","height","rotation"],"type":"object"},"post":{"anyOf":[{"$ref":"#/components/schemas/InstagramStickerPost"},{"type":"null"}]},"startTime":{"type":["number","null"]},"targetMediaId":{"minLength":1,"type":["string","null"]},"title":{"minLength":1,"type":["string","null"]},"type":{"minLength":1,"type":["string","null"]},"url":{"format":"uri","minLength":1,"type":["string","null"]},"user":{"anyOf":[{"$ref":"#/components/schemas/InstagramProfileReference"},{"type":"null"}]}},"required":["id","type","position","isHidden","isPinned","user","post","targetMediaId","startTime","endTime","audio","url","title","hashtag"],"type":"object"},"InstagramStickerPost":{"additionalProperties":false,"properties":{"code":{"minLength":1,"type":["string","null"]},"id":{"minLength":1,"type":["string","null"]},"mediaType":{"minLength":1,"type":["string","null"]},"productType":{"minLength":1,"type":["string","null"]},"url":{"format":"uri","minLength":1,"type":["string","null"]}},"required":["id","code","mediaType","productType","url"],"type":"object"},"InstagramStory":{"additionalProperties":false,"properties":{"ai":{"additionalProperties":false,"properties":{"detectionMethod":{"minLength":1,"type":["string","null"]},"label":{"additionalProperties":false,"properties":{"detectionMethod":{"minLength":1,"type":["string","null"]},"isSelfDisclosed":{"type":["boolean","null"]},"subtitle":{"minLength":1,"type":["string","null"]},"text":{"minLength":1,"type":["string","null"]}},"required":["text","subtitle","detectionMethod","isSelfDisclosed"],"type":"object"}},"required":["detectionMethod","label"],"type":"object"},"attribution":{"additionalProperties":false,"properties":{"originalPost":{"anyOf":[{"$ref":"#/components/schemas/InstagramPostReference"},{"type":"null"}]}},"required":["originalPost"],"type":"object"},"author":{"anyOf":[{"$ref":"#/components/schemas/InstagramProfileReference"},{"type":"null"}]},"caption":{"anyOf":[{"$ref":"#/components/schemas/InstagramCaptionReference"},{"type":"null"}]},"carousel":{"additionalProperties":false,"properties":{"itemCount":{"type":["integer","null"]},"pendingItemCount":{"type":["integer","null"]},"previousSubmitters":{"items":{"$ref":"#/components/schemas/InstagramProfileReference"},"type":["array","null"]},"submissionState":{"minLength":1,"type":["string","null"]}},"required":["itemCount","pendingItemCount","submissionState","previousSubmitters"],"type":"object"},"code":{"minLength":1,"type":["string","null"]},"collaborators":{"items":{"$ref":"#/components/schemas/InstagramProfileReference"},"type":["array","null"]},"comments":{"$ref":"#/components/schemas/InstagramCommentSettings"},"createdAt":{"format":"date-time","minLength":1,"type":"string"},"crossposting":{"additionalProperties":false,"properties":{"isFeedbackAggregated":{"type":["boolean","null"]},"isSharedToFacebook":{"type":["boolean","null"]}},"required":["isSharedToFacebook","isFeedbackAggregated"],"type":"object"},"expiresAt":{"format":"date-time","minLength":1,"type":["string","null"]},"extracted":{"$ref":"#/components/schemas/InstagramExtracted"},"fbid":{"minLength":1,"type":["string","null"]},"hasDelayedMetadata":{"type":["boolean","null"]},"hasTaggedUsers":{"type":["boolean","null"]},"hasVisualReplies":{"type":["boolean","null"]},"highlights":{"items":{"$ref":"#/components/schemas/InstagramHighlightReference"},"type":["array","null"]},"id":{"minLength":1,"type":"string"},"invitedCollaborators":{"items":{"$ref":"#/components/schemas/InstagramProfileReference"},"type":["array","null"]},"isEarlyAccess":{"type":["boolean","null"]},"isEdited":{"type":["boolean","null"]},"isFanClubPromo":{"type":["boolean","null"]},"isLastVideoSegment":{"type":["boolean","null"]},"isOpenToPublicSubmission":{"type":["boolean","null"]},"isPaidPartnership":{"type":["boolean","null"]},"isPublicChatWelcomeVideo":{"type":["boolean","null"]},"language":{"minLength":1,"type":["string","null"]},"likeAndViewCountsHidden":{"type":["boolean","null"]},"location":{"anyOf":[{"$ref":"#/components/schemas/InstagramLocationReference"},{"type":"null"}]},"media":{"items":{"$ref":"#/components/schemas/InstagramMedia"},"type":"array"},"metrics":{"$ref":"#/components/schemas/InstagramPostMetrics"},"notes":{"items":{"$ref":"#/components/schemas/InstagramNote"},"type":["array","null"]},"pinning":{"additionalProperties":false,"properties":{"profileUserIds":{"items":{"minLength":1,"type":"string"},"type":["array","null"]},"reelsUserIds":{"items":{"minLength":1,"type":"string"},"type":["array","null"]}},"required":["profileUserIds","reelsUserIds"],"type":"object"},"productTags":{"items":{"$ref":"#/components/schemas/InstagramProductTag"},"type":["array","null"]},"remix":{"additionalProperties":false,"properties":{"allowed":{"type":["boolean","null"]},"carouselRemixesAllowed":{"type":["boolean","null"]},"crosspostingAllowed":{"type":["boolean","null"]},"hasBeenRemixed":{"type":["boolean","null"]},"isRequestingRemixes":{"type":["boolean","null"]}},"required":["allowed","carouselRemixesAllowed","hasBeenRemixed","isRequestingRemixes","crosspostingAllowed"],"type":"object"},"reuse":{"additionalProperties":false,"properties":{"allowed":{"type":["boolean","null"]},"cutoutStickersAllowed":{"type":["boolean","null"]}},"required":["allowed","cutoutStickersAllowed"],"type":"object"},"shareCountHidden":{"type":["boolean","null"]},"sharingEnabled":{"type":["boolean","null"]},"stickers":{"items":{"$ref":"#/components/schemas/InstagramSticker"},"type":["array","null"]},"taggedUsers":{"items":{"$ref":"#/components/schemas/InstagramUserTag"},"type":["array","null"]},"template":{"anyOf":[{"$ref":"#/components/schemas/InstagramTemplateInfo"},{"type":"null"}]},"text":{"minLength":1,"type":["string","null"]},"title":{"minLength":1,"type":["string","null"]},"type":{"minLength":1,"type":["string","null"]},"url":{"format":"uri","minLength":1,"type":"string"}},"required":["id","code","fbid","type","url","title","text","extracted","createdAt","author","caption","media","metrics","comments","taggedUsers","productTags","collaborators","invitedCollaborators","location","isPaidPartnership","isEarlyAccess","likeAndViewCountsHidden","shareCountHidden","hasVisualReplies","hasDelayedMetadata","language","hasTaggedUsers","isOpenToPublicSubmission","sharingEnabled","isFanClubPromo","isPublicChatWelcomeVideo","reuse","remix","pinning","carousel","ai","notes","crossposting","attribution","template","expiresAt","isEdited","isLastVideoSegment","stickers","highlights"],"type":"object"},"InstagramStoryCollection":{"additionalProperties":false,"properties":{"audience":{"additionalProperties":false,"properties":{"hasCloseFriendsStories":{"type":["boolean","null"]},"hasSubscriberStories":{"type":["boolean","null"]}},"required":["hasCloseFriendsStories","hasSubscriberStories"],"type":"object"},"expiresAt":{"format":"date-time","minLength":1,"type":["string","null"]},"id":{"minLength":1,"type":["string","null"]},"isArchived":{"type":["boolean","null"]},"lastStoryAt":{"format":"date-time","minLength":1,"type":["string","null"]},"metrics":{"additionalProperties":false,"properties":{"stories":{"type":["integer","null"]}},"required":["stories"],"type":"object"}},"required":["id","lastStoryAt","expiresAt","isArchived","metrics","audience"],"type":"object"},"InstagramStoryReference":{"additionalProperties":false,"properties":{"ai":{"additionalProperties":false,"properties":{"detectionMethod":{"minLength":1,"type":["string","null"]},"label":{"additionalProperties":false,"properties":{"detectionMethod":{"minLength":1,"type":["string","null"]},"isSelfDisclosed":{"type":["boolean","null"]},"subtitle":{"minLength":1,"type":["string","null"]},"text":{"minLength":1,"type":["string","null"]}},"required":["text","subtitle","detectionMethod","isSelfDisclosed"],"type":"object"}},"required":["detectionMethod","label"],"type":"object"},"attribution":{"additionalProperties":false,"properties":{"originalPost":{"anyOf":[{"$ref":"#/components/schemas/InstagramPostReference"},{"type":"null"}]}},"required":["originalPost"],"type":"object"},"author":{"anyOf":[{"$ref":"#/components/schemas/InstagramProfileReference"},{"type":"null"}]},"caption":{"anyOf":[{"$ref":"#/components/schemas/InstagramCaptionReference"},{"type":"null"}]},"carousel":{"additionalProperties":false,"properties":{"itemCount":{"type":["integer","null"]},"pendingItemCount":{"type":["integer","null"]},"previousSubmitters":{"items":{"$ref":"#/components/schemas/InstagramProfileReference"},"type":["array","null"]},"submissionState":{"minLength":1,"type":["string","null"]}},"required":["itemCount","pendingItemCount","submissionState","previousSubmitters"],"type":"object"},"code":{"minLength":1,"type":["string","null"]},"collaborators":{"items":{"$ref":"#/components/schemas/InstagramProfileReference"},"type":["array","null"]},"comments":{"$ref":"#/components/schemas/InstagramCommentSettings"},"createdAt":{"format":"date-time","minLength":1,"type":["string","null"]},"crossposting":{"additionalProperties":false,"properties":{"isFeedbackAggregated":{"type":["boolean","null"]},"isSharedToFacebook":{"type":["boolean","null"]}},"required":["isSharedToFacebook","isFeedbackAggregated"],"type":"object"},"expiresAt":{"format":"date-time","minLength":1,"type":["string","null"]},"extracted":{"$ref":"#/components/schemas/InstagramExtracted"},"fbid":{"minLength":1,"type":["string","null"]},"hasDelayedMetadata":{"type":["boolean","null"]},"hasTaggedUsers":{"type":["boolean","null"]},"hasVisualReplies":{"type":["boolean","null"]},"highlights":{"items":{"$ref":"#/components/schemas/InstagramHighlightReference"},"type":["array","null"]},"id":{"minLength":1,"type":["string","null"]},"invitedCollaborators":{"items":{"$ref":"#/components/schemas/InstagramProfileReference"},"type":["array","null"]},"isEarlyAccess":{"type":["boolean","null"]},"isEdited":{"type":["boolean","null"]},"isFanClubPromo":{"type":["boolean","null"]},"isLastVideoSegment":{"type":["boolean","null"]},"isOpenToPublicSubmission":{"type":["boolean","null"]},"isPaidPartnership":{"type":["boolean","null"]},"isPublicChatWelcomeVideo":{"type":["boolean","null"]},"language":{"minLength":1,"type":["string","null"]},"likeAndViewCountsHidden":{"type":["boolean","null"]},"location":{"anyOf":[{"$ref":"#/components/schemas/InstagramLocationReference"},{"type":"null"}]},"media":{"items":{"$ref":"#/components/schemas/InstagramMedia"},"type":["array","null"]},"metrics":{"$ref":"#/components/schemas/InstagramPostMetrics"},"notes":{"items":{"$ref":"#/components/schemas/InstagramNote"},"type":["array","null"]},"pinning":{"additionalProperties":false,"properties":{"profileUserIds":{"items":{"minLength":1,"type":"string"},"type":["array","null"]},"reelsUserIds":{"items":{"minLength":1,"type":"string"},"type":["array","null"]}},"required":["profileUserIds","reelsUserIds"],"type":"object"},"productTags":{"items":{"$ref":"#/components/schemas/InstagramProductTag"},"type":["array","null"]},"remix":{"additionalProperties":false,"properties":{"allowed":{"type":["boolean","null"]},"carouselRemixesAllowed":{"type":["boolean","null"]},"crosspostingAllowed":{"type":["boolean","null"]},"hasBeenRemixed":{"type":["boolean","null"]},"isRequestingRemixes":{"type":["boolean","null"]}},"required":["allowed","carouselRemixesAllowed","hasBeenRemixed","isRequestingRemixes","crosspostingAllowed"],"type":"object"},"reuse":{"additionalProperties":false,"properties":{"allowed":{"type":["boolean","null"]},"cutoutStickersAllowed":{"type":["boolean","null"]}},"required":["allowed","cutoutStickersAllowed"],"type":"object"},"shareCountHidden":{"type":["boolean","null"]},"sharingEnabled":{"type":["boolean","null"]},"stickers":{"items":{"$ref":"#/components/schemas/InstagramSticker"},"type":["array","null"]},"taggedUsers":{"items":{"$ref":"#/components/schemas/InstagramUserTag"},"type":["array","null"]},"template":{"anyOf":[{"$ref":"#/components/schemas/InstagramTemplateInfo"},{"type":"null"}]},"text":{"minLength":1,"type":["string","null"]},"title":{"minLength":1,"type":["string","null"]},"type":{"minLength":1,"type":["string","null"]},"url":{"format":"uri","minLength":1,"type":["string","null"]}},"required":["id","code","fbid","type","url","title","text","extracted","createdAt","author","caption","media","metrics","comments","taggedUsers","productTags","collaborators","invitedCollaborators","location","isPaidPartnership","isEarlyAccess","likeAndViewCountsHidden","shareCountHidden","hasVisualReplies","hasDelayedMetadata","language","hasTaggedUsers","isOpenToPublicSubmission","sharingEnabled","isFanClubPromo","isPublicChatWelcomeVideo","reuse","remix","pinning","carousel","ai","notes","crossposting","attribution","template","expiresAt","isEdited","isLastVideoSegment","stickers","highlights"],"type":"object"},"InstagramStreamVariant":{"additionalProperties":false,"properties":{"bitrate":{"type":["integer","null"]},"codec":{"minLength":1,"type":["string","null"]},"frameRate":{"type":["number","null"]},"height":{"type":["integer","null"]},"id":{"minLength":1,"type":["string","null"]},"mimeType":{"minLength":1,"type":["string","null"]},"qualityLabel":{"minLength":1,"type":["string","null"]},"sampleRate":{"type":["integer","null"]},"sizeBytes":{"type":["integer","null"]},"url":{"format":"uri","minLength":1,"type":["string","null"]},"width":{"type":["integer","null"]}},"required":["id","url","codec","mimeType","qualityLabel","width","height","bitrate","sizeBytes","sampleRate","frameRate"],"type":"object"},"InstagramStreaming":{"additionalProperties":false,"properties":{"dash":{"anyOf":[{"$ref":"#/components/schemas/InstagramDASH"},{"type":"null"}]}},"required":["dash"],"type":"object"},"InstagramSubtitles":{"additionalProperties":false,"properties":{"confidence":{"type":["number","null"]},"enabled":{"type":["boolean","null"]},"generated":{"type":["boolean","null"]},"locale":{"minLength":1,"type":["string","null"]},"status":{"minLength":1,"type":["string","null"]},"url":{"format":"uri","minLength":1,"type":["string","null"]}},"required":["enabled","generated","status","locale","confidence","url"],"type":"object"},"InstagramSuggestion":{"additionalProperties":false,"properties":{"caption":{"minLength":1,"type":["string","null"]},"hasStoryRing":{"type":["boolean","null"]},"icon":{"minLength":1,"type":["string","null"]},"isNew":{"type":["boolean","null"]},"largeImages":{"items":{"$ref":"#/components/schemas/InstagramImage"},"type":["array","null"]},"posts":{"items":{"$ref":"#/components/schemas/InstagramPostReference"},"type":["array","null"]},"socialContext":{"minLength":1,"type":["string","null"]},"thumbnails":{"items":{"$ref":"#/components/schemas/InstagramImage"},"type":["array","null"]}},"required":["socialContext","hasStoryRing","isNew","icon","caption","thumbnails","largeImages","posts"],"type":"object"},"InstagramTemplate":{"additionalProperties":false,"properties":{"audioTitle":{"minLength":1,"type":["string","null"]},"author":{"anyOf":[{"$ref":"#/components/schemas/InstagramProfileReference"},{"type":"null"}]},"effectId":{"minLength":1,"type":["string","null"]},"effects":{"additionalProperties":false,"properties":{"segments":{"items":{},"type":["array","null"]}},"required":["segments"],"type":"object"},"minimumSegments":{"type":["integer","null"]},"postId":{"minLength":1,"type":["string","null"]},"posts":{"items":{"$ref":"#/components/schemas/InstagramPostReference"},"type":["array","null"]},"segments":{"items":{"$ref":"#/components/schemas/InstagramTemplateSegment"},"type":["array","null"]},"title":{"minLength":1,"type":["string","null"]},"usageLabel":{"minLength":1,"type":["string","null"]}},"required":["postId","author","minimumSegments","segments","effectId","effects","title","audioTitle","usageLabel","posts"],"type":"object"},"InstagramTemplateInfo":{"additionalProperties":false,"properties":{"author":{"anyOf":[{"$ref":"#/components/schemas/InstagramProfileReference"},{"type":"null"}]},"effectId":{"minLength":1,"type":["string","null"]},"effects":{"additionalProperties":false,"properties":{"segments":{"items":{},"type":["array","null"]}},"required":["segments"],"type":"object"},"minimumSegments":{"type":["integer","null"]},"postId":{"minLength":1,"type":["string","null"]},"segments":{"items":{"$ref":"#/components/schemas/InstagramTemplateSegment"},"type":["array","null"]}},"required":["postId","author","minimumSegments","segments","effectId","effects"],"type":"object"},"InstagramTemplateSegment":{"additionalProperties":false,"properties":{"assetEndTime":{"type":["number","null"]},"assetStartTime":{"type":["number","null"]},"duration":{"type":["number","null"]}},"required":["duration","assetStartTime","assetEndTime"],"type":"object"},"InstagramUserTag":{"additionalProperties":false,"properties":{"position":{"$ref":"#/components/schemas/InstagramPosition"},"user":{"$ref":"#/components/schemas/InstagramProfileReference"}},"required":["user","position"],"type":"object"},"MessageEnvelope":{"additionalProperties":false,"properties":{"message":{"minLength":1,"type":"string"}},"required":["message"],"type":"object"},"RedditAuthor":{"additionalProperties":false,"properties":{"flair":{"anyOf":[{"$ref":"#/components/schemas/RedditFlair"},{"type":"null"}]},"handle":{"minLength":1,"type":["string","null"]},"id":{"minLength":1,"type":["string","null"]},"isPremium":{"type":["boolean","null"]},"placeholder":{"minLength":1,"type":["string","null"]}},"required":["id","handle","placeholder","isPremium","flair"],"type":"object"},"RedditComment":{"additionalProperties":false,"properties":{"author":{"anyOf":[{"$ref":"#/components/schemas/RedditAuthor"},{"type":"null"}]},"community":{"anyOf":[{"$ref":"#/components/schemas/RedditCommunity"},{"type":"null"}]},"createdAt":{"format":"date-time","minLength":1,"type":"string"},"depth":{"type":["integer","null"]},"display":{"$ref":"#/components/schemas/RedditCommentDisplay"},"distinguishedBy":{"minLength":1,"type":["string","null"]},"editedAt":{"format":"date-time","minLength":1,"type":["string","null"]},"extracted":{"$ref":"#/components/schemas/RedditExtracted"},"id":{"minLength":1,"type":"string"},"isArchived":{"type":["boolean","null"]},"isByPostAuthor":{"type":["boolean","null"]},"isControversial":{"type":["boolean","null"]},"isEdited":{"type":["boolean","null"]},"isLocked":{"type":["boolean","null"]},"isStickied":{"type":["boolean","null"]},"metrics":{"$ref":"#/components/schemas/RedditCommentMetrics"},"parentId":{"minLength":1,"type":["string","null"]},"postId":{"minLength":1,"type":["string","null"]},"replies":{"items":{"$ref":"#/components/schemas/RedditCommentReference"},"type":["array","null"]},"text":{"minLength":1,"type":["string","null"]},"textHtml":{"minLength":1,"type":["string","null"]},"type":{"minLength":1,"type":["string","null"]},"url":{"format":"uri","minLength":1,"type":"string"},"visibility":{"$ref":"#/components/schemas/RedditCommentVisibility"}},"required":["id","text","textHtml","extracted","author","community","postId","parentId","url","metrics","visibility","isByPostAuthor","isStickied","isLocked","isArchived","distinguishedBy","type","display","createdAt","isEdited","editedAt","isControversial","depth","replies"],"type":"object"},"RedditCommentDisplay":{"additionalProperties":false,"properties":{"collapsedReason":{"minLength":1,"type":["string","null"]},"isCollapsed":{"type":["boolean","null"]}},"required":["isCollapsed","collapsedReason"],"type":"object"},"RedditCommentMetrics":{"additionalProperties":false,"properties":{"awards":{"type":["integer","null"]},"gilded":{"type":["integer","null"]},"score":{"type":["integer","null"]}},"required":["score","awards","gilded"],"type":"object"},"RedditCommentReference":{"additionalProperties":false,"properties":{"author":{"anyOf":[{"$ref":"#/components/schemas/RedditAuthor"},{"type":"null"}]},"community":{"anyOf":[{"$ref":"#/components/schemas/RedditCommunity"},{"type":"null"}]},"createdAt":{"format":"date-time","minLength":1,"type":["string","null"]},"depth":{"type":["integer","null"]},"display":{"$ref":"#/components/schemas/RedditCommentDisplay"},"distinguishedBy":{"minLength":1,"type":["string","null"]},"editedAt":{"format":"date-time","minLength":1,"type":["string","null"]},"extracted":{"$ref":"#/components/schemas/RedditExtracted"},"id":{"minLength":1,"type":["string","null"]},"isArchived":{"type":["boolean","null"]},"isByPostAuthor":{"type":["boolean","null"]},"isControversial":{"type":["boolean","null"]},"isEdited":{"type":["boolean","null"]},"isLocked":{"type":["boolean","null"]},"isStickied":{"type":["boolean","null"]},"metrics":{"$ref":"#/components/schemas/RedditCommentMetrics"},"parentId":{"minLength":1,"type":["string","null"]},"postId":{"minLength":1,"type":["string","null"]},"replies":{"items":{"$ref":"#/components/schemas/RedditCommentReference"},"type":["array","null"]},"text":{"minLength":1,"type":["string","null"]},"textHtml":{"minLength":1,"type":["string","null"]},"type":{"minLength":1,"type":["string","null"]},"url":{"format":"uri","minLength":1,"type":["string","null"]},"visibility":{"$ref":"#/components/schemas/RedditCommentVisibility"}},"required":["id","text","textHtml","extracted","author","community","postId","parentId","url","metrics","visibility","isByPostAuthor","isStickied","isLocked","isArchived","distinguishedBy","type","display","createdAt","isEdited","editedAt","isControversial","depth","replies"],"type":"object"},"RedditCommentSettings":{"additionalProperties":false,"properties":{"restrictCommenting":{"type":["boolean","null"]},"scoreHideDuration":{"type":["integer","null"]},"suggestedSort":{"minLength":1,"type":["string","null"]}},"required":["restrictCommenting","suggestedSort","scoreHideDuration"],"type":"object"},"RedditCommentVisibility":{"additionalProperties":false,"properties":{"isScoreHidden":{"type":["boolean","null"]}},"required":["isScoreHidden"],"type":"object"},"RedditCommentsSetting":{"additionalProperties":false,"properties":{"allowLiveComments":{"type":["boolean","null"]},"discussionType":{"minLength":1,"type":["string","null"]},"isContestMode":{"type":["boolean","null"]},"suggestedSort":{"minLength":1,"type":["string","null"]}},"required":["isContestMode","allowLiveComments","suggestedSort","discussionType"],"type":"object"},"RedditCommunity":{"additionalProperties":false,"properties":{"displayHandle":{"minLength":1,"type":["string","null"]},"handle":{"minLength":1,"type":["string","null"]},"id":{"minLength":1,"type":["string","null"]},"isQuarantined":{"type":["boolean","null"]},"metrics":{"$ref":"#/components/schemas/RedditSubredditMetrics"},"type":{"minLength":1,"type":["string","null"]}},"required":["id","handle","displayHandle","type","metrics","isQuarantined"],"type":"object"},"RedditCommunityHandle":{"additionalProperties":false,"properties":{"handle":{"minLength":1,"type":["string","null"]}},"required":["handle"],"type":"object"},"RedditDisplaySettings":{"additionalProperties":false,"properties":{"showMedia":{"type":["boolean","null"]}},"required":["showMedia"],"type":"object"},"RedditEmbed":{"additionalProperties":false,"properties":{"author":{"anyOf":[{"$ref":"#/components/schemas/RedditEmbedAuthor"},{"type":"null"}]},"domain":{"minLength":1,"type":["string","null"]},"height":{"type":["integer","null"]},"html":{"minLength":1,"type":["string","null"]},"mediaDomainUrl":{"format":"uri","minLength":1,"type":["string","null"]},"provider":{"anyOf":[{"$ref":"#/components/schemas/RedditEmbedSource"},{"type":"null"}]},"scrolling":{"type":["boolean","null"]},"thumbnail":{"anyOf":[{"$ref":"#/components/schemas/RedditThumbnail"},{"type":"null"}]},"title":{"minLength":1,"type":["string","null"]},"type":{"minLength":1,"type":["string","null"]},"version":{"minLength":1,"type":["string","null"]},"width":{"type":["integer","null"]}},"required":["domain","version","title","type","html","height","width","provider","author","thumbnail","scrolling","mediaDomainUrl"],"type":"object"},"RedditEmbedAuthor":{"additionalProperties":false,"properties":{"displayName":{"minLength":1,"type":["string","null"]},"url":{"format":"uri","minLength":1,"type":["string","null"]}},"required":["displayName","url"],"type":"object"},"RedditEmbedSource":{"additionalProperties":false,"properties":{"name":{"minLength":1,"type":["string","null"]},"url":{"format":"uri","minLength":1,"type":["string","null"]}},"required":["name","url"],"type":"object"},"RedditExtracted":{"additionalProperties":false,"properties":{"emails":{"items":{"minLength":1,"type":"string"},"type":["array","null"]},"handles":{"items":{"$ref":"#/components/schemas/RedditExtractedHandle"},"type":["array","null"]},"links":{"items":{"minLength":1,"type":"string"},"type":["array","null"]},"phones":{"items":{"minLength":1,"type":"string"},"type":["array","null"]}},"required":["emails","phones","links","handles"],"type":"object"},"RedditExtractedHandle":{"additionalProperties":false,"properties":{"handle":{"minLength":1,"type":["string","null"]},"platform":{"minLength":1,"type":["string","null"]}},"required":["platform","handle"],"type":"object"},"RedditFlair":{"additionalProperties":false,"properties":{"backgroundColor":{"minLength":1,"type":["string","null"]},"cssClass":{"minLength":1,"type":["string","null"]},"hasPatreonFlair":{"type":["boolean","null"]},"templateId":{"minLength":1,"type":["string","null"]},"text":{"minLength":1,"type":["string","null"]},"textColor":{"minLength":1,"type":["string","null"]},"type":{"minLength":1,"type":["string","null"]}},"required":["text","type","templateId","cssClass","backgroundColor","textColor","hasPatreonFlair"],"type":"object"},"RedditImage":{"additionalProperties":false,"properties":{"height":{"type":["integer","null"]},"label":{"minLength":1,"type":["string","null"]},"type":{"minLength":1,"type":["string","null"]},"url":{"format":"uri","minLength":1,"type":["string","null"]},"variants":{"items":{"$ref":"#/components/schemas/RedditImage"},"type":["array","null"]},"width":{"type":["integer","null"]}},"required":["type","url","label","width","height","variants"],"type":"object"},"RedditKarma":{"additionalProperties":false,"properties":{"awardee":{"type":["integer","null"]},"awarder":{"type":["integer","null"]},"comments":{"type":["integer","null"]},"posts":{"type":["integer","null"]},"total":{"type":["integer","null"]}},"required":["posts","comments","awardee","awarder","total"],"type":"object"},"RedditListingContext":{"additionalProperties":false,"properties":{"originalPost":{"anyOf":[{"$ref":"#/components/schemas/RedditPostReference"},{"type":"null"}]},"post":{"anyOf":[{"$ref":"#/components/schemas/RedditPostReference"},{"type":"null"}]}},"required":["post","originalPost"],"type":"object"},"RedditMedia":{"additionalProperties":false,"properties":{"bitrateKbps":{"type":["integer","null"]},"caption":{"minLength":1,"type":["string","null"]},"duration":{"type":["number","null"]},"hasAudio":{"type":["boolean","null"]},"height":{"type":["integer","null"]},"id":{"minLength":1,"type":["string","null"]},"isAnimated":{"type":["boolean","null"]},"mimeType":{"minLength":1,"type":["string","null"]},"scrubber":{"anyOf":[{"$ref":"#/components/schemas/RedditMediaVariant"},{"type":"null"}]},"transcodingStatus":{"minLength":1,"type":["string","null"]},"type":{"minLength":1,"type":["string","null"]},"url":{"format":"uri","minLength":1,"type":["string","null"]},"variants":{"items":{"$ref":"#/components/schemas/RedditMediaVariant"},"type":["array","null"]},"width":{"type":["integer","null"]}},"required":["type","id","width","height","mimeType","caption","url","variants","bitrateKbps","hasAudio","duration","isAnimated","transcodingStatus","scrubber"],"type":"object"},"RedditMediaVariant":{"additionalProperties":false,"properties":{"format":{"minLength":1,"type":["string","null"]},"type":{"minLength":1,"type":["string","null"]},"url":{"format":"uri","minLength":1,"type":["string","null"]}},"required":["format","type","url"],"type":"object"},"RedditPageMetadata":{"additionalProperties":false,"properties":{"community":{"anyOf":[{"$ref":"#/components/schemas/RedditCommunityHandle"},{"type":"null"}]},"context":{"anyOf":[{"$ref":"#/components/schemas/RedditListingContext"},{"type":"null"}]},"count":{"type":["integer","null"]},"domain":{"minLength":1,"type":["string","null"]},"handle":{"minLength":1,"type":["string","null"]},"hasMore":{"type":["boolean","null"]},"limit":{"type":["integer","null"]},"previousCursor":{"minLength":1,"type":["string","null"]},"query":{"minLength":1,"type":["string","null"]},"siteRules":{"items":{"minLength":1,"type":"string"},"type":["array","null"]},"sort":{"minLength":1,"type":["string","null"]}},"required":["count","limit","hasMore","previousCursor","query","sort","domain","handle","community","siteRules","context"],"type":"object"},"RedditPost":{"additionalProperties":false,"properties":{"author":{"anyOf":[{"$ref":"#/components/schemas/RedditAuthor"},{"type":"null"}]},"comments":{"$ref":"#/components/schemas/RedditCommentsSetting"},"community":{"anyOf":[{"$ref":"#/components/schemas/RedditCommunity"},{"type":"null"}]},"createdAt":{"format":"date-time","minLength":1,"type":"string"},"distinguishedBy":{"minLength":1,"type":["string","null"]},"domain":{"minLength":1,"type":["string","null"]},"editedAt":{"format":"date-time","minLength":1,"type":["string","null"]},"embed":{"anyOf":[{"$ref":"#/components/schemas/RedditEmbed"},{"type":"null"}]},"extracted":{"$ref":"#/components/schemas/RedditExtracted"},"flair":{"anyOf":[{"$ref":"#/components/schemas/RedditFlair"},{"type":"null"}]},"id":{"minLength":1,"type":"string"},"isArchived":{"type":["boolean","null"]},"isCrosspostable":{"type":["boolean","null"]},"isEdited":{"type":["boolean","null"]},"isGallery":{"type":["boolean","null"]},"isLocked":{"type":["boolean","null"]},"isMediaOnly":{"type":["boolean","null"]},"isMeta":{"type":["boolean","null"]},"isOriginalContent":{"type":["boolean","null"]},"isPinned":{"type":["boolean","null"]},"isRedditMediaDomain":{"type":["boolean","null"]},"isSelf":{"type":["boolean","null"]},"isSensitive":{"type":["boolean","null"]},"isSpoiler":{"type":["boolean","null"]},"isStickied":{"type":["boolean","null"]},"isVideo":{"type":["boolean","null"]},"linkUrl":{"format":"uri","minLength":1,"type":["string","null"]},"media":{"items":{"$ref":"#/components/schemas/RedditMedia"},"type":"array"},"metrics":{"$ref":"#/components/schemas/RedditPostMetrics"},"removedByCategory":{"minLength":1,"type":["string","null"]},"text":{"minLength":1,"type":["string","null"]},"textHtml":{"minLength":1,"type":["string","null"]},"thumbnail":{"anyOf":[{"$ref":"#/components/schemas/RedditThumbnail"},{"type":"null"}]},"title":{"minLength":1,"type":["string","null"]},"topAwardedType":{"minLength":1,"type":["string","null"]},"url":{"format":"uri","minLength":1,"type":"string"},"visibility":{"$ref":"#/components/schemas/RedditPostVisibility"}},"required":["id","title","text","textHtml","extracted","domain","url","linkUrl","author","community","metrics","createdAt","isEdited","editedAt","isSelf","isVideo","isGallery","isMeta","isOriginalContent","isCrosspostable","isRedditMediaDomain","isMediaOnly","isSensitive","isSpoiler","isStickied","isLocked","isArchived","isPinned","visibility","comments","distinguishedBy","removedByCategory","topAwardedType","flair","thumbnail","media","embed"],"type":"object"},"RedditPostFlairSettings":{"additionalProperties":false,"properties":{"enabled":{"type":["boolean","null"]},"position":{"minLength":1,"type":["string","null"]}},"required":["enabled","position"],"type":"object"},"RedditPostMetrics":{"additionalProperties":false,"properties":{"awards":{"type":["integer","null"]},"comments":{"type":["integer","null"]},"crossposts":{"type":["integer","null"]},"gilded":{"type":["integer","null"]},"score":{"type":["integer","null"]},"upvoteRatio":{"type":["number","null"]},"views":{"type":["integer","null"]}},"required":["score","upvoteRatio","comments","crossposts","awards","gilded","views"],"type":"object"},"RedditPostReference":{"additionalProperties":false,"properties":{"author":{"anyOf":[{"$ref":"#/components/schemas/RedditAuthor"},{"type":"null"}]},"comments":{"$ref":"#/components/schemas/RedditCommentsSetting"},"community":{"anyOf":[{"$ref":"#/components/schemas/RedditCommunity"},{"type":"null"}]},"createdAt":{"format":"date-time","minLength":1,"type":["string","null"]},"distinguishedBy":{"minLength":1,"type":["string","null"]},"domain":{"minLength":1,"type":["string","null"]},"editedAt":{"format":"date-time","minLength":1,"type":["string","null"]},"embed":{"anyOf":[{"$ref":"#/components/schemas/RedditEmbed"},{"type":"null"}]},"extracted":{"$ref":"#/components/schemas/RedditExtracted"},"flair":{"anyOf":[{"$ref":"#/components/schemas/RedditFlair"},{"type":"null"}]},"id":{"minLength":1,"type":["string","null"]},"isArchived":{"type":["boolean","null"]},"isCrosspostable":{"type":["boolean","null"]},"isEdited":{"type":["boolean","null"]},"isGallery":{"type":["boolean","null"]},"isLocked":{"type":["boolean","null"]},"isMediaOnly":{"type":["boolean","null"]},"isMeta":{"type":["boolean","null"]},"isOriginalContent":{"type":["boolean","null"]},"isPinned":{"type":["boolean","null"]},"isRedditMediaDomain":{"type":["boolean","null"]},"isSelf":{"type":["boolean","null"]},"isSensitive":{"type":["boolean","null"]},"isSpoiler":{"type":["boolean","null"]},"isStickied":{"type":["boolean","null"]},"isVideo":{"type":["boolean","null"]},"linkUrl":{"format":"uri","minLength":1,"type":["string","null"]},"media":{"items":{"$ref":"#/components/schemas/RedditMedia"},"type":["array","null"]},"metrics":{"$ref":"#/components/schemas/RedditPostMetrics"},"removedByCategory":{"minLength":1,"type":["string","null"]},"text":{"minLength":1,"type":["string","null"]},"textHtml":{"minLength":1,"type":["string","null"]},"thumbnail":{"anyOf":[{"$ref":"#/components/schemas/RedditThumbnail"},{"type":"null"}]},"title":{"minLength":1,"type":["string","null"]},"topAwardedType":{"minLength":1,"type":["string","null"]},"url":{"format":"uri","minLength":1,"type":["string","null"]},"visibility":{"$ref":"#/components/schemas/RedditPostVisibility"}},"required":["id","title","text","textHtml","extracted","domain","url","linkUrl","author","community","metrics","createdAt","isEdited","editedAt","isSelf","isVideo","isGallery","isMeta","isOriginalContent","isCrosspostable","isRedditMediaDomain","isMediaOnly","isSensitive","isSpoiler","isStickied","isLocked","isArchived","isPinned","visibility","comments","distinguishedBy","removedByCategory","topAwardedType","flair","thumbnail","media","embed"],"type":"object"},"RedditPostVisibility":{"additionalProperties":false,"properties":{"isRobotIndexable":{"type":["boolean","null"]},"isScoreHidden":{"type":["boolean","null"]}},"required":["isRobotIndexable","isScoreHidden"],"type":"object"},"RedditPostingLabels":{"additionalProperties":false,"properties":{"link":{"minLength":1,"type":["string","null"]},"text":{"minLength":1,"type":["string","null"]}},"required":["text","link"],"type":"object"},"RedditPostingSettings":{"additionalProperties":false,"properties":{"allOriginalContent":{"type":["boolean","null"]},"allowGalleries":{"type":["boolean","null"]},"allowImages":{"type":["boolean","null"]},"allowPolls":{"type":["boolean","null"]},"allowVideos":{"type":["boolean","null"]},"instructions":{"anyOf":[{"$ref":"#/components/schemas/RedditText"},{"type":"null"}]},"labels":{"anyOf":[{"$ref":"#/components/schemas/RedditPostingLabels"},{"type":"null"}]},"originalContentTagEnabled":{"type":["boolean","null"]},"restrictPosting":{"type":["boolean","null"]},"spoilersEnabled":{"type":["boolean","null"]},"type":{"minLength":1,"type":["string","null"]}},"required":["type","instructions","labels","allowImages","allowVideos","allowGalleries","allowPolls","spoilersEnabled","originalContentTagEnabled","allOriginalContent","restrictPosting"],"type":"object"},"RedditProfile":{"additionalProperties":false,"properties":{"acceptsFollowers":{"type":["boolean","null"]},"avatar":{"anyOf":[{"$ref":"#/components/schemas/RedditImage"},{"type":"null"}]},"banner":{"anyOf":[{"$ref":"#/components/schemas/RedditImage"},{"type":"null"}]},"bio":{"minLength":1,"type":["string","null"]},"createdAt":{"format":"date-time","minLength":1,"type":["string","null"]},"displayHandle":{"minLength":1,"type":["string","null"]},"displayName":{"minLength":1,"type":["string","null"]},"extracted":{"$ref":"#/components/schemas/RedditExtracted"},"handle":{"minLength":1,"type":"string"},"id":{"minLength":1,"type":"string"},"isEmployee":{"type":["boolean","null"]},"isModerator":{"type":["boolean","null"]},"isPremium":{"type":["boolean","null"]},"isSensitive":{"type":["boolean","null"]},"metrics":{"$ref":"#/components/schemas/RedditProfileMetrics"},"profileCommunity":{"anyOf":[{"$ref":"#/components/schemas/RedditProfileCommunity"},{"type":"null"}]},"snoovatar":{"anyOf":[{"$ref":"#/components/schemas/RedditImage"},{"type":"null"}]},"url":{"format":"uri","minLength":1,"type":"string"},"verification":{"$ref":"#/components/schemas/RedditVerification"},"visibility":{"$ref":"#/components/schemas/RedditProfileVisibility"}},"required":["id","handle","displayHandle","displayName","bio","extracted","url","createdAt","avatar","snoovatar","banner","isPremium","isEmployee","isModerator","acceptsFollowers","isSensitive","verification","visibility","metrics","profileCommunity"],"type":"object"},"RedditProfileCommunity":{"additionalProperties":false,"properties":{"communityIcon":{"anyOf":[{"$ref":"#/components/schemas/RedditImage"},{"type":"null"}]},"displayHandle":{"minLength":1,"type":["string","null"]},"handle":{"minLength":1,"type":["string","null"]},"icon":{"anyOf":[{"$ref":"#/components/schemas/RedditImage"},{"type":"null"}]},"primaryColor":{"minLength":1,"type":["string","null"]},"type":{"minLength":1,"type":["string","null"]}},"required":["handle","type","displayHandle","icon","communityIcon","primaryColor"],"type":"object"},"RedditProfileMetrics":{"additionalProperties":false,"properties":{"followers":{"type":["integer","null"]},"karma":{"$ref":"#/components/schemas/RedditKarma"}},"required":["followers","karma"],"type":"object"},"RedditProfileVisibility":{"additionalProperties":false,"properties":{"hideFromRobots":{"type":["boolean","null"]}},"required":["hideFromRobots"],"type":"object"},"RedditReportSettings":{"additionalProperties":false,"properties":{"allowCustomReasons":{"type":["boolean","null"]}},"required":["allowCustomReasons"],"type":"object"},"RedditRule":{"additionalProperties":false,"properties":{"createdAt":{"format":"date-time","minLength":1,"type":["string","null"]},"description":{"anyOf":[{"$ref":"#/components/schemas/RedditText"},{"type":"null"}]},"kind":{"minLength":1,"type":["string","null"]},"name":{"minLength":1,"type":"string"},"priority":{"type":["integer","null"]},"violationReason":{"minLength":1,"type":["string","null"]}},"required":["priority","name","violationReason","kind","description","createdAt"],"type":"object"},"RedditSubreddit":{"additionalProperties":false,"properties":{"acceptsFollowers":{"type":["boolean","null"]},"avatar":{"anyOf":[{"$ref":"#/components/schemas/RedditImage"},{"type":"null"}]},"banner":{"anyOf":[{"$ref":"#/components/schemas/RedditImage"},{"type":"null"}]},"branding":{"$ref":"#/components/schemas/RedditSubredditBranding"},"createdAt":{"format":"date-time","minLength":1,"type":["string","null"]},"description":{"anyOf":[{"$ref":"#/components/schemas/RedditText"},{"type":"null"}]},"displayHandle":{"minLength":1,"type":["string","null"]},"displayName":{"minLength":1,"type":["string","null"]},"handle":{"minLength":1,"type":"string"},"id":{"minLength":1,"type":"string"},"isQuarantined":{"type":["boolean","null"]},"isSensitive":{"type":["boolean","null"]},"language":{"minLength":1,"type":["string","null"]},"metrics":{"$ref":"#/components/schemas/RedditSubredditMetrics"},"settings":{"$ref":"#/components/schemas/RedditSubredditSettings"},"summary":{"anyOf":[{"$ref":"#/components/schemas/RedditText"},{"type":"null"}]},"type":{"minLength":1,"type":["string","null"]},"url":{"format":"uri","minLength":1,"type":"string"}},"required":["id","handle","displayHandle","displayName","type","language","url","createdAt","isQuarantined","isSensitive","acceptsFollowers","metrics","description","summary","settings","branding","avatar","banner"],"type":"object"},"RedditSubredditBranding":{"additionalProperties":false,"properties":{"banner":{"anyOf":[{"$ref":"#/components/schemas/RedditImage"},{"type":"null"}]},"colors":{"$ref":"#/components/schemas/RedditSubredditColors"},"header":{"anyOf":[{"$ref":"#/components/schemas/RedditImage"},{"type":"null"}]},"headerTitle":{"minLength":1,"type":["string","null"]},"icon":{"anyOf":[{"$ref":"#/components/schemas/RedditImage"},{"type":"null"}]}},"required":["headerTitle","colors","icon","banner","header"],"type":"object"},"RedditSubredditColors":{"additionalProperties":false,"properties":{"bannerBackground":{"minLength":1,"type":["string","null"]},"key":{"minLength":1,"type":["string","null"]},"primary":{"minLength":1,"type":["string","null"]}},"required":["primary","key","bannerBackground"],"type":"object"},"RedditSubredditMetrics":{"additionalProperties":false,"properties":{"subscribers":{"type":["integer","null"]}},"required":["subscribers"],"type":"object"},"RedditSubredditSettings":{"additionalProperties":false,"properties":{"comments":{"$ref":"#/components/schemas/RedditCommentSettings"},"display":{"$ref":"#/components/schemas/RedditDisplaySettings"},"postFlair":{"$ref":"#/components/schemas/RedditPostFlairSettings"},"posting":{"$ref":"#/components/schemas/RedditPostingSettings"},"reports":{"$ref":"#/components/schemas/RedditReportSettings"}},"required":["posting","comments","reports","display","postFlair"],"type":"object"},"RedditText":{"additionalProperties":false,"properties":{"html":{"minLength":1,"type":["string","null"]},"text":{"minLength":1,"type":["string","null"]}},"required":["text","html"],"type":"object"},"RedditThumbnail":{"additionalProperties":false,"properties":{"height":{"type":["integer","null"]},"state":{"minLength":1,"type":["string","null"]},"type":{"minLength":1,"type":["string","null"]},"url":{"format":"uri","minLength":1,"type":["string","null"]},"width":{"type":["integer","null"]}},"required":["type","url","state","width","height"],"type":"object"},"RedditTrophy":{"additionalProperties":false,"properties":{"awardId":{"minLength":1,"type":["string","null"]},"description":{"minLength":1,"type":["string","null"]},"grantedAt":{"format":"date-time","minLength":1,"type":["string","null"]},"icon":{"anyOf":[{"$ref":"#/components/schemas/RedditImage"},{"type":"null"}]},"id":{"minLength":1,"type":["string","null"]},"name":{"minLength":1,"type":"string"},"url":{"format":"uri","minLength":1,"type":["string","null"]}},"required":["id","awardId","name","description","url","grantedAt","icon"],"type":"object"},"RedditVerification":{"additionalProperties":false,"properties":{"hasVerifiedEmail":{"type":["boolean","null"]},"reportedVerified":{"type":["boolean","null"]}},"required":["reportedVerified","hasVerifiedEmail"],"type":"object"},"RedditWikiAuthor":{"additionalProperties":false,"properties":{"handle":{"minLength":1,"type":["string","null"]}},"required":["handle"],"type":"object"},"RedditWikiContent":{"additionalProperties":false,"properties":{"html":{"minLength":1,"type":["string","null"]},"markdown":{"minLength":1,"type":["string","null"]}},"required":["markdown","html"],"type":"object"},"RedditWikiPage":{"additionalProperties":false,"properties":{"content":{"anyOf":[{"$ref":"#/components/schemas/RedditWikiContent"},{"type":"null"}]},"revision":{"anyOf":[{"$ref":"#/components/schemas/RedditWikiRevision"},{"type":"null"}]},"title":{"minLength":1,"type":"string"},"url":{"format":"uri","minLength":1,"type":"string"}},"required":["title","url","content","revision"],"type":"object"},"RedditWikiRevision":{"additionalProperties":false,"properties":{"author":{"anyOf":[{"$ref":"#/components/schemas/RedditWikiAuthor"},{"type":"null"}]},"createdAt":{"format":"date-time","minLength":1,"type":["string","null"]},"id":{"minLength":1,"type":["string","null"]},"reason":{"minLength":1,"type":["string","null"]}},"required":["id","reason","author","createdAt"],"type":"object"},"ResponseCursors":{"properties":{"next":{"type":["string","null"]}},"required":["next"],"type":"object"},"ResponseMeta":{"properties":{"cashtags":{"items":{},"type":["array","null"]},"category":{"minLength":1,"type":["string","null"]},"chart":{"anyOf":[{"$ref":"#/components/schemas/TikTokChartMetadata"},{"type":"null"}]},"chartWeek":{"anyOf":[{"$ref":"#/components/schemas/YouTubeChartWeek"},{"type":"null"}]},"collection":{"anyOf":[{"$ref":"#/components/schemas/InstagramStoryCollection"},{"type":"null"}]},"comments":{"type":["integer","null"]},"community":{"anyOf":[{"$ref":"#/components/schemas/RedditCommunityHandle"},{"type":"null"}]},"context":{"anyOf":[{"$ref":"#/components/schemas/RedditListingContext"},{"type":"null"}]},"continuation":{"anyOf":[{"$ref":"#/components/schemas/TikTokPageContinuation"},{"type":"null"}]},"count":{"type":["integer","null"]},"country":{"minLength":1,"type":["string","null"]},"cursors":{"$ref":"#/components/schemas/ResponseCursors"},"domain":{"minLength":1,"type":["string","null"]},"estimatedResults":{"type":["integer","null"]},"events":{"items":{},"type":["array","null"]},"handle":{"minLength":1,"type":["string","null"]},"hasFilteredComments":{"type":["boolean","null"]},"hasMore":{"type":["boolean","null"]},"hasMoreAfter":{"type":["boolean","null"]},"hasMoreBefore":{"type":["boolean","null"]},"hashtag":{"anyOf":[{"$ref":"#/components/schemas/YouTubeHashtag"},{"type":"null"}]},"hashtags":{"items":{},"type":["array","null"]},"isLimited":{"type":"boolean"},"likesEnabled":{"type":["boolean","null"]},"limit":{"type":["integer","null"]},"lists":{"items":{},"type":["array","null"]},"metrics":{"properties":{"comments":{"type":["integer","null"]},"followers":{"type":["integer","null"]},"following":{"type":["integer","null"]},"likes":{"type":["integer","null"]},"replies":{"type":["integer","null"]},"results":{"type":["integer","null"]},"suggestions":{"type":["integer","null"]}},"type":"object"},"nextCursorLabel":{"minLength":1,"type":["string","null"]},"nextCursorType":{"minLength":1,"type":["string","null"]},"parent":{"anyOf":[{"$ref":"#/components/schemas/InstagramCommentReference"},{"type":"null"}]},"playlist":{"anyOf":[{"$ref":"#/components/schemas/YouTubePlaylistReference"},{"type":"null"}]},"previousCursor":{"minLength":1,"type":["string","null"]},"promoted":{"items":{"$ref":"#/components/schemas/TwitterPostReference"},"type":["array","null"]},"queries":{"items":{"$ref":"#/components/schemas/TwitterSuggestedQuery"},"type":["array","null"]},"query":{"minLength":1,"type":["string","null"]},"siteRules":{"items":{"minLength":1,"type":"string"},"type":["array","null"]},"sort":{"minLength":1,"type":["string","null"]},"threadingEnabled":{"type":["boolean","null"]},"track":{"anyOf":[{"$ref":"#/components/schemas/InstagramAudioReference"},{"type":"null"}]}},"required":["cursors"],"type":"object"},"SuccessEnvelope":{"additionalProperties":false,"properties":{"capturedAt":{"format":"date-time","type":"string"},"data":{},"meta":{"$ref":"#/components/schemas/ResponseMeta"},"platform":{"enum":["instagram","tiktok","twitter","reddit","youtube"],"type":"string"},"resource":{"enum":["profile","post","comment","hashtag","location","music","category","list","entity","story","highlight","subreddit","rule","wiki","trophy","playlist","transcript","product","chart","files","storyboard","frame"],"type":"string"},"source":{"enum":["live","cache"],"type":"string"}},"required":["platform","resource","capturedAt","source","data"],"type":"object"},"TestDataCatalog":{"additionalProperties":false,"properties":{"changeNotes":{"items":{"type":"string"},"type":"array"},"contentHash":{"minLength":1,"type":"string"},"datasetVersion":{"minLength":1,"type":"string"},"entries":{"items":{"$ref":"#/components/schemas/TestDataEntry"},"type":"array"},"mediaProvenanceUrl":{"format":"uri","type":"string"},"operations":{"items":{"$ref":"#/components/schemas/TestDataOperation"},"type":"array"},"synthetic":{"const":true,"type":"boolean"}},"required":["datasetVersion","contentHash","mediaProvenanceUrl","synthetic","changeNotes","operations","entries"],"type":"object"},"TestDataCatalogEnvelope":{"additionalProperties":false,"properties":{"data":{"$ref":"#/components/schemas/TestDataCatalog"}},"required":["data"],"type":"object"},"TestDataEntry":{"additionalProperties":false,"properties":{"datasetVersion":{"minLength":1,"type":"string"},"description":{"minLength":1,"type":"string"},"expected":{"$ref":"#/components/schemas/TestDataExpectedResult"},"id":{"minLength":1,"type":"string"},"inputs":{"additionalProperties":{"type":"string"},"type":"object"},"label":{"minLength":1,"type":"string"},"operationIds":{"items":{"minLength":1,"type":"string"},"type":"array"},"platform":{"enum":["instagram","tiktok","twitter","reddit","youtube"],"type":"string"},"relationships":{"items":{"$ref":"#/components/schemas/TestDataRelationship"},"type":"array"},"resource":{"enum":["profile","post","comment","hashtag","location","music","category","list","entity","subreddit","rule","wiki","trophy","playlist","transcript","product","chart","files","storyboard","frame"],"type":"string"},"synthetic":{"const":true,"type":"boolean"},"traits":{"items":{"minLength":1,"type":"string"},"type":"array"}},"required":["id","datasetVersion","platform","resource","label","description","traits","inputs","expected","relationships","operationIds","synthetic"],"type":"object"},"TestDataEntryEnvelope":{"additionalProperties":false,"properties":{"data":{"$ref":"#/components/schemas/TestDataEntry"}},"required":["data"],"type":"object"},"TestDataExpectedResult":{"additionalProperties":false,"properties":{"errorCode":{"minLength":1,"type":"string"},"status":{"enum":[200,403,404],"type":"integer"}},"required":["status"],"type":"object"},"TestDataOperation":{"additionalProperties":false,"properties":{"description":{"minLength":1,"type":"string"},"id":{"minLength":1,"type":"string"},"inputFields":{"items":{"minLength":1,"type":"string"},"type":"array"},"locators":{"items":{"minLength":1,"type":"string"},"type":"array"},"method":{"const":"GET","type":"string"},"paginated":{"type":"boolean"},"path":{"minLength":1,"type":"string"},"platform":{"enum":["instagram","tiktok","twitter","reddit","youtube"],"type":"string"},"publicSchema":{"minLength":1,"type":"string"},"resource":{"enum":["profile","post","comment","hashtag","location","music","category","list","entity","subreddit","rule","wiki","trophy","playlist","transcript","product","chart","files","storyboard","frame"],"type":"string"},"summary":{"minLength":1,"type":"string"},"toolName":{"minLength":1,"type":"string"}},"required":["id","platform","resource","publicSchema","method","path","summary","description","inputFields","locators","paginated","toolName"],"type":"object"},"TestDataRelationship":{"additionalProperties":false,"properties":{"entryId":{"minLength":1,"type":"string"},"type":{"minLength":1,"type":"string"}},"required":["type","entryId"],"type":"object"},"TikTokAudio":{"additionalProperties":false,"properties":{"hash":{"minLength":1,"type":["string","null"]},"id":{"minLength":1,"type":["string","null"]},"renditions":{"items":{"$ref":"#/components/schemas/TikTokRendition"},"type":["array","null"]},"size":{"type":["integer","null"]},"url":{"format":"uri","minLength":1,"type":["string","null"]},"urls":{"items":{"minLength":1,"type":"string"},"type":["array","null"]},"volumeInfo":{"$ref":"#/components/schemas/TikTokVolumeInfo"}},"required":["volumeInfo","id","url","size","hash","urls","renditions"],"type":"object"},"TikTokBeatData":{"additionalProperties":false,"properties":{"hash":{"minLength":1,"type":["string","null"]},"id":{"minLength":1,"type":["string","null"]},"resources":{"items":{"$ref":"#/components/schemas/TikTokBeatResource"},"type":["array","null"]},"size":{"type":["integer","null"]},"url":{"format":"uri","minLength":1,"type":["string","null"]},"urls":{"items":{"minLength":1,"type":"string"},"type":["array","null"]}},"required":["id","url","size","hash","urls","resources"],"type":"object"},"TikTokBeatResource":{"additionalProperties":false,"properties":{"role":{"minLength":1,"type":["string","null"]},"url":{"format":"uri","minLength":1,"type":["string","null"]}},"required":["role","url"],"type":"object"},"TikTokCategory":{"additionalProperties":false,"properties":{"avatar":{"anyOf":[{"$ref":"#/components/schemas/TikTokImage"},{"type":"null"}]},"categoryContext":{"$ref":"#/components/schemas/TikTokCategoryContext"},"classification":{"$ref":"#/components/schemas/TikTokHashtagClassification"},"cover":{"anyOf":[{"$ref":"#/components/schemas/TikTokImage"},{"type":"null"}]},"description":{"minLength":1,"type":["string","null"]},"id":{"minLength":1,"type":"string"},"isCommerce":{"type":["boolean","null"]},"isStrongMusic":{"type":["boolean","null"]},"metrics":{"$ref":"#/components/schemas/TikTokHashtagMetrics"},"music":{"items":{"$ref":"#/components/schemas/TikTokMusicReference"},"type":["array","null"]},"name":{"minLength":1,"type":["string","null"]},"previewPosts":{"items":{"$ref":"#/components/schemas/TikTokPostReference"},"type":["array","null"]},"searchContext":{"$ref":"#/components/schemas/TikTokHashtagSearchContext"},"url":{"format":"uri","minLength":1,"type":"string"}},"required":["id","name","url","description","isCommerce","isStrongMusic","classification","metrics","avatar","cover","music","searchContext","categoryContext","previewPosts"],"type":"object"},"TikTokCategoryContext":{"additionalProperties":false,"properties":{"label":{"minLength":1,"type":["string","null"]},"typeCode":{"type":["integer","null"]}},"required":["typeCode","label"],"type":"object"},"TikTokChartMetadata":{"additionalProperties":false,"properties":{"cover":{"anyOf":[{"$ref":"#/components/schemas/TikTokImage"},{"type":"null"}]},"id":{"minLength":1,"type":["string","null"]},"updatedAt":{"format":"date-time","minLength":1,"type":["string","null"]}},"required":["id","updatedAt","cover"],"type":"object"},"TikTokCollaborator":{"additionalProperties":false,"properties":{"profile":{"$ref":"#/components/schemas/TikTokProfileReference"},"status":{"type":["integer","null"]}},"required":["profile","status"],"type":"object"},"TikTokComment":{"additionalProperties":false,"properties":{"author":{"anyOf":[{"$ref":"#/components/schemas/TikTokProfileReference"},{"type":"null"}]},"createdAt":{"format":"date-time","minLength":1,"type":"string"},"entities":{"items":{"$ref":"#/components/schemas/TikTokTextEntity"},"type":["array","null"]},"extracted":{"$ref":"#/components/schemas/TikTokExtracted"},"id":{"minLength":1,"type":"string"},"isLikedByCreator":{"type":["boolean","null"]},"isPinned":{"type":["boolean","null"]},"labels":{"items":{"$ref":"#/components/schemas/TikTokCommentLabel"},"type":["array","null"]},"language":{"minLength":1,"type":["string","null"]},"media":{"items":{"$ref":"#/components/schemas/TikTokImage"},"type":["array","null"]},"metrics":{"$ref":"#/components/schemas/TikTokCommentMetrics"},"parentId":{"minLength":1,"type":["string","null"]},"postId":{"minLength":1,"type":["string","null"]},"predictions":{"$ref":"#/components/schemas/TikTokCommentPredictions"},"previewReplies":{"items":{"$ref":"#/components/schemas/TikTokCommentReference"},"type":["array","null"]},"replyTo":{"anyOf":[{"$ref":"#/components/schemas/TikTokProfileReference"},{"type":"null"}]},"rootCommentId":{"minLength":1,"type":["string","null"]},"sticker":{"anyOf":[{"$ref":"#/components/schemas/TikTokCommentSticker"},{"type":"null"}]},"text":{"minLength":1,"type":["string","null"]}},"required":["id","postId","text","extracted","createdAt","language","author","isPinned","isLikedByCreator","parentId","rootCommentId","replyTo","metrics","predictions","entities","labels","previewReplies","media","sticker"],"type":"object"},"TikTokCommentLabel":{"additionalProperties":false,"properties":{"text":{"minLength":1,"type":["string","null"]},"typeCode":{"type":["integer","null"]}},"required":["text","typeCode"],"type":"object"},"TikTokCommentMetrics":{"additionalProperties":false,"properties":{"likes":{"type":["integer","null"]},"replies":{"type":["integer","null"]}},"required":["likes","replies"],"type":"object"},"TikTokCommentPredictions":{"additionalProperties":false,"properties":{"highPurchaseIntent":{"type":["boolean","null"]}},"required":["highPurchaseIntent"],"type":"object"},"TikTokCommentReference":{"additionalProperties":false,"properties":{"author":{"anyOf":[{"$ref":"#/components/schemas/TikTokProfileReference"},{"type":"null"}]},"createdAt":{"format":"date-time","minLength":1,"type":["string","null"]},"entities":{"items":{"$ref":"#/components/schemas/TikTokTextEntity"},"type":["array","null"]},"extracted":{"$ref":"#/components/schemas/TikTokExtracted"},"id":{"minLength":1,"type":["string","null"]},"isLikedByCreator":{"type":["boolean","null"]},"isPinned":{"type":["boolean","null"]},"labels":{"items":{"$ref":"#/components/schemas/TikTokCommentLabel"},"type":["array","null"]},"language":{"minLength":1,"type":["string","null"]},"media":{"items":{"$ref":"#/components/schemas/TikTokImage"},"type":["array","null"]},"metrics":{"$ref":"#/components/schemas/TikTokCommentMetrics"},"parentId":{"minLength":1,"type":["string","null"]},"postId":{"minLength":1,"type":["string","null"]},"predictions":{"$ref":"#/components/schemas/TikTokCommentPredictions"},"previewReplies":{"items":{"$ref":"#/components/schemas/TikTokCommentReference"},"type":["array","null"]},"replyTo":{"anyOf":[{"$ref":"#/components/schemas/TikTokProfileReference"},{"type":"null"}]},"rootCommentId":{"minLength":1,"type":["string","null"]},"sticker":{"anyOf":[{"$ref":"#/components/schemas/TikTokCommentSticker"},{"type":"null"}]},"text":{"minLength":1,"type":["string","null"]}},"required":["id","postId","text","extracted","createdAt","language","author","isPinned","isLikedByCreator","parentId","rootCommentId","replyTo","metrics","predictions","entities","labels","previewReplies","media","sticker"],"type":"object"},"TikTokCommentSticker":{"additionalProperties":false,"properties":{"createdAt":{"format":"date-time","minLength":1,"type":["string","null"]},"creatorId":{"minLength":1,"type":["string","null"]},"id":{"minLength":1,"type":["string","null"]},"name":{"minLength":1,"type":["string","null"]},"renditions":{"items":{"$ref":"#/components/schemas/TikTokImage"},"type":["array","null"]},"setId":{"minLength":1,"type":["string","null"]},"typeCode":{"type":["integer","null"]}},"required":["id","creatorId","setId","name","typeCode","createdAt","renditions"],"type":"object"},"TikTokCommerceMetrics":{"additionalProperties":false,"properties":{"products":{"type":["integer","null"]}},"required":["products"],"type":"object"},"TikTokCoordinates":{"additionalProperties":false,"properties":{"geohash":{"minLength":1,"type":["string","null"]},"latitude":{"type":["number","null"]},"longitude":{"type":["number","null"]}},"required":["latitude","longitude","geohash"],"type":"object"},"TikTokDistrict":{"additionalProperties":false,"properties":{"id":{"minLength":1,"type":["string","null"]},"name":{"minLength":1,"type":["string","null"]},"parentName":{"minLength":1,"type":["string","null"]}},"required":["id","name","parentName"],"type":"object"},"TikTokEffect":{"additionalProperties":false,"properties":{"attributions":{"items":{"$ref":"#/components/schemas/TikTokUnspecified"},"type":["array","null"]},"children":{"items":{"$ref":"#/components/schemas/TikTokUnspecified"},"type":["array","null"]},"classification":{"$ref":"#/components/schemas/TikTokEffectClassification"},"creation":{"$ref":"#/components/schemas/TikTokEffectCreation"},"description":{"minLength":1,"type":["string","null"]},"effectId":{"minLength":1,"type":["string","null"]},"icon":{"anyOf":[{"$ref":"#/components/schemas/TikTokImage"},{"type":"null"}]},"id":{"minLength":1,"type":"string"},"isTopEffect":{"type":["boolean","null"]},"linkedAnchors":{"items":{"$ref":"#/components/schemas/TikTokUnspecified"},"type":["array","null"]},"metrics":{"$ref":"#/components/schemas/TikTokEffectMetrics"},"name":{"minLength":1,"type":["string","null"]},"owner":{"anyOf":[{"$ref":"#/components/schemas/TikTokEffectOwner"},{"type":"null"}]},"publishedAt":{"format":"date-time","minLength":1,"type":["string","null"]},"resourceId":{"minLength":1,"type":["string","null"]},"tags":{"items":{"minLength":1,"type":"string"},"type":["array","null"]},"triggers":{"items":{"$ref":"#/components/schemas/TikTokEffectTrigger"},"type":["array","null"]},"url":{"format":"uri","minLength":1,"type":"string"}},"required":["id","effectId","resourceId","name","description","publishedAt","url","isTopEffect","tags","owner","icon","metrics","classification","creation","triggers","children","attributions","linkedAnchors"],"type":"object"},"TikTokEffectClassification":{"additionalProperties":false,"properties":{"creatorTypeCode":{"type":["integer","null"]},"sourceCode":{"type":["integer","null"]}},"required":["creatorTypeCode","sourceCode"],"type":"object"},"TikTokEffectCreation":{"additionalProperties":false,"properties":{"isEffectHouse":{"type":["boolean","null"]},"isExternalProducer":{"type":["boolean","null"]}},"required":["isEffectHouse","isExternalProducer"],"type":"object"},"TikTokEffectMetrics":{"additionalProperties":false,"properties":{"uses":{"type":["integer","null"]},"views":{"type":["integer","null"]}},"required":["uses","views"],"type":"object"},"TikTokEffectOwner":{"additionalProperties":false,"properties":{"avatar":{"anyOf":[{"$ref":"#/components/schemas/TikTokImage"},{"type":"null"}]},"displayName":{"minLength":1,"type":["string","null"]},"id":{"minLength":1,"type":["string","null"]},"isTopEffectDesigner":{"type":["boolean","null"]},"secUid":{"minLength":1,"type":["string","null"]},"verification":{"$ref":"#/components/schemas/TikTokEffectOwnerVerification"}},"required":["id","secUid","displayName","avatar","isTopEffectDesigner","verification"],"type":"object"},"TikTokEffectOwnerVerification":{"additionalProperties":false,"properties":{"typeCode":{"type":["integer","null"]}},"required":["typeCode"],"type":"object"},"TikTokEffectReference":{"additionalProperties":false,"properties":{"attributions":{"items":{"$ref":"#/components/schemas/TikTokUnspecified"},"type":["array","null"]},"children":{"items":{"$ref":"#/components/schemas/TikTokUnspecified"},"type":["array","null"]},"classification":{"$ref":"#/components/schemas/TikTokEffectClassification"},"creation":{"$ref":"#/components/schemas/TikTokEffectCreation"},"description":{"minLength":1,"type":["string","null"]},"effectId":{"minLength":1,"type":["string","null"]},"icon":{"anyOf":[{"$ref":"#/components/schemas/TikTokImage"},{"type":"null"}]},"id":{"minLength":1,"type":["string","null"]},"isTopEffect":{"type":["boolean","null"]},"linkedAnchors":{"items":{"$ref":"#/components/schemas/TikTokUnspecified"},"type":["array","null"]},"metrics":{"$ref":"#/components/schemas/TikTokEffectMetrics"},"name":{"minLength":1,"type":["string","null"]},"owner":{"anyOf":[{"$ref":"#/components/schemas/TikTokEffectOwner"},{"type":"null"}]},"publishedAt":{"format":"date-time","minLength":1,"type":["string","null"]},"resourceId":{"minLength":1,"type":["string","null"]},"tags":{"items":{"minLength":1,"type":"string"},"type":["array","null"]},"triggers":{"items":{"$ref":"#/components/schemas/TikTokEffectTrigger"},"type":["array","null"]},"url":{"format":"uri","minLength":1,"type":["string","null"]}},"required":["id","effectId","resourceId","name","description","publishedAt","url","isTopEffect","tags","owner","icon","metrics","classification","creation","triggers","children","attributions","linkedAnchors"],"type":"object"},"TikTokEffectTrigger":{"additionalProperties":false,"properties":{"actionCodes":{"items":{"type":"integer"},"type":["array","null"]},"type":{"minLength":1,"type":["string","null"]}},"required":["type","actionCodes"],"type":"object"},"TikTokExtracted":{"additionalProperties":false,"properties":{"emails":{"items":{"minLength":1,"type":"string"},"type":["array","null"]},"handles":{"items":{"$ref":"#/components/schemas/TikTokExtractedHandle"},"type":["array","null"]},"links":{"items":{"minLength":1,"type":"string"},"type":["array","null"]},"phones":{"items":{"minLength":1,"type":"string"},"type":["array","null"]}},"required":["emails","phones","links","handles"],"type":"object"},"TikTokExtractedHandle":{"additionalProperties":false,"properties":{"handle":{"minLength":1,"type":["string","null"]},"platform":{"minLength":1,"type":["string","null"]}},"required":["platform","handle"],"type":"object"},"TikTokHashtag":{"additionalProperties":false,"properties":{"avatar":{"anyOf":[{"$ref":"#/components/schemas/TikTokImage"},{"type":"null"}]},"classification":{"$ref":"#/components/schemas/TikTokHashtagClassification"},"cover":{"anyOf":[{"$ref":"#/components/schemas/TikTokImage"},{"type":"null"}]},"description":{"minLength":1,"type":["string","null"]},"id":{"minLength":1,"type":"string"},"isCommerce":{"type":["boolean","null"]},"isStrongMusic":{"type":["boolean","null"]},"metrics":{"$ref":"#/components/schemas/TikTokHashtagMetrics"},"music":{"items":{"$ref":"#/components/schemas/TikTokMusicReference"},"type":["array","null"]},"name":{"minLength":1,"type":["string","null"]},"searchContext":{"$ref":"#/components/schemas/TikTokHashtagSearchContext"},"url":{"format":"uri","minLength":1,"type":"string"}},"required":["id","name","url","description","isCommerce","isStrongMusic","classification","metrics","avatar","cover","music","searchContext"],"type":"object"},"TikTokHashtagClassification":{"additionalProperties":false,"properties":{"challengeCode":{"type":["integer","null"]},"subtypeCode":{"type":["integer","null"]},"typeCode":{"type":["integer","null"]}},"required":["typeCode","subtypeCode","challengeCode"],"type":"object"},"TikTokHashtagMetrics":{"additionalProperties":false,"properties":{"users":{"type":["integer","null"]},"uses":{"type":["integer","null"]},"views":{"type":["integer","null"]}},"required":["uses","users","views"],"type":"object"},"TikTokHashtagReference":{"additionalProperties":false,"properties":{"id":{"minLength":1,"type":["string","null"]},"name":{"minLength":1,"type":["string","null"]},"url":{"format":"uri","minLength":1,"type":["string","null"]}},"required":["id","name","url"],"type":"object"},"TikTokHashtagSearchContext":{"additionalProperties":false,"properties":{"name":{"minLength":1,"type":["string","null"]}},"required":["name"],"type":"object"},"TikTokImage":{"additionalProperties":false,"properties":{"hash":{"minLength":1,"type":["string","null"]},"height":{"type":["integer","null"]},"id":{"minLength":1,"type":["string","null"]},"label":{"minLength":1,"type":["string","null"]},"renditions":{"items":{"$ref":"#/components/schemas/TikTokImage"},"type":["array","null"]},"role":{"minLength":1,"type":["string","null"]},"size":{"type":["integer","null"]},"url":{"format":"uri","minLength":1,"type":["string","null"]},"urls":{"items":{"minLength":1,"type":"string"},"type":["array","null"]},"width":{"type":["integer","null"]}},"required":["id","url","width","height","size","hash","role","label","urls","renditions"],"type":"object"},"TikTokInteractionSticker":{"additionalProperties":false,"properties":{"hashtag":{"anyOf":[{"$ref":"#/components/schemas/TikTokHashtagReference"},{"type":"null"}]},"index":{"type":["integer","null"]},"isTextHashtag":{"type":["boolean","null"]},"materialIndex":{"type":["integer","null"]},"positions":{"items":{"$ref":"#/components/schemas/TikTokStickerPosition"},"type":["array","null"]},"text":{"minLength":1,"type":["string","null"]},"typeCode":{"type":["integer","null"]}},"required":["typeCode","index","materialIndex","text","hashtag","isTextHashtag","positions"],"type":"object"},"TikTokLocation":{"additionalProperties":false,"properties":{"address":{"$ref":"#/components/schemas/TikTokLocationAddress"},"category":{"minLength":1,"type":["string","null"]},"classification":{"$ref":"#/components/schemas/TikTokLocationClassification"},"commerce":{"$ref":"#/components/schemas/TikTokLocationCommerce"},"coordinates":{"$ref":"#/components/schemas/TikTokCoordinates"},"externalUrl":{"format":"uri","minLength":1,"type":["string","null"]},"id":{"minLength":1,"type":"string"},"metrics":{"$ref":"#/components/schemas/TikTokLocationMetrics"},"name":{"minLength":1,"type":["string","null"]},"openingHours":{"$ref":"#/components/schemas/TikTokOpeningHours"},"parent":{"anyOf":[{"$ref":"#/components/schemas/TikTokLocationParent"},{"type":"null"}]},"priceLevel":{"minLength":1,"type":["string","null"]},"rating":{"$ref":"#/components/schemas/TikTokLocationRating"},"source":{"minLength":1,"type":["string","null"]},"url":{"format":"uri","minLength":1,"type":["string","null"]}},"required":["id","name","category","source","url","address","coordinates","parent","classification","metrics","rating","priceLevel","externalUrl","openingHours","commerce"],"type":"object"},"TikTokLocationAddress":{"additionalProperties":false,"properties":{"city":{"minLength":1,"type":["string","null"]},"cityCode":{"minLength":1,"type":["string","null"]},"countryCode":{"minLength":1,"type":["string","null"]},"district":{"anyOf":[{"$ref":"#/components/schemas/TikTokDistrict"},{"type":"null"}]},"fallback":{"minLength":1,"type":["string","null"]},"formatted":{"minLength":1,"type":["string","null"]},"regionCode":{"minLength":1,"type":["string","null"]}},"required":["formatted","fallback","city","cityCode","regionCode","countryCode","district"],"type":"object"},"TikTokLocationClassification":{"additionalProperties":false,"properties":{"backendType":{"minLength":1,"type":["string","null"]},"className":{"minLength":1,"type":["string","null"]},"code":{"minLength":1,"type":["string","null"]},"detailType":{"minLength":1,"type":["string","null"]},"hierarchy":{"items":{"minLength":1,"type":"string"},"type":["array","null"]},"levelCode":{"minLength":1,"type":["string","null"]},"serviceCategory":{"$ref":"#/components/schemas/TikTokServiceCategory"},"sourceCode":{"type":["integer","null"]}},"required":["code","className","detailType","sourceCode","levelCode","backendType","hierarchy","serviceCategory"],"type":"object"},"TikTokLocationCommerce":{"additionalProperties":false,"properties":{"hasProductShelf":{"type":["boolean","null"]},"isClaimed":{"type":["boolean","null"]}},"required":["hasProductShelf","isClaimed"],"type":"object"},"TikTokLocationMetrics":{"additionalProperties":false,"properties":{"favorites":{"type":["integer","null"]},"reviews":{"type":["integer","null"]},"videos":{"type":["integer","null"]}},"required":["favorites","reviews","videos"],"type":"object"},"TikTokLocationParent":{"additionalProperties":false,"properties":{"id":{"minLength":1,"type":["string","null"]},"name":{"minLength":1,"type":["string","null"]}},"required":["id","name"],"type":"object"},"TikTokLocationRating":{"additionalProperties":false,"properties":{"hasRating":{"type":["boolean","null"]},"maxScore":{"type":["number","null"]},"score":{"type":["number","null"]},"source":{"$ref":"#/components/schemas/TikTokRatingSource"}},"required":["score","maxScore","hasRating","source"],"type":"object"},"TikTokLocationReference":{"additionalProperties":false,"properties":{"address":{"$ref":"#/components/schemas/TikTokLocationAddress"},"category":{"minLength":1,"type":["string","null"]},"classification":{"$ref":"#/components/schemas/TikTokLocationClassification"},"commerce":{"$ref":"#/components/schemas/TikTokLocationCommerce"},"coordinates":{"$ref":"#/components/schemas/TikTokCoordinates"},"externalUrl":{"format":"uri","minLength":1,"type":["string","null"]},"id":{"minLength":1,"type":["string","null"]},"metrics":{"$ref":"#/components/schemas/TikTokLocationMetrics"},"name":{"minLength":1,"type":["string","null"]},"openingHours":{"$ref":"#/components/schemas/TikTokOpeningHours"},"parent":{"anyOf":[{"$ref":"#/components/schemas/TikTokLocationParent"},{"type":"null"}]},"priceLevel":{"minLength":1,"type":["string","null"]},"rating":{"$ref":"#/components/schemas/TikTokLocationRating"},"source":{"minLength":1,"type":["string","null"]},"url":{"format":"uri","minLength":1,"type":["string","null"]}},"required":["id","name","category","source","url","address","coordinates","parent","classification","metrics","rating","priceLevel","externalUrl","openingHours","commerce"],"type":"object"},"TikTokLyricAsset":{"additionalProperties":false,"properties":{"id":{"minLength":1,"type":["string","null"]},"typeCode":{"type":["integer","null"]},"url":{"format":"uri","minLength":1,"type":["string","null"]}},"required":["id","typeCode","url"],"type":"object"},"TikTokMatchedTrack":{"additionalProperties":false,"properties":{"artistName":{"minLength":1,"type":["string","null"]},"artists":{"items":{"$ref":"#/components/schemas/TikTokProfileReference"},"type":["array","null"]},"chorus":{"$ref":"#/components/schemas/TikTokMusicPreview"},"cover":{"anyOf":[{"$ref":"#/components/schemas/TikTokImage"},{"type":"null"}]},"duration":{"type":["number","null"]},"id":{"minLength":1,"type":["string","null"]},"mixedArtistName":{"minLength":1,"type":["string","null"]},"mixedTitle":{"minLength":1,"type":["string","null"]},"release":{"$ref":"#/components/schemas/TikTokMusicRelease"},"title":{"minLength":1,"type":["string","null"]},"url":{"format":"uri","minLength":1,"type":["string","null"]}},"required":["id","title","artistName","mixedTitle","mixedArtistName","cover","duration","chorus","url","artists","release"],"type":"object"},"TikTokMedia":{"additionalProperties":false,"properties":{"covers":{"items":{"$ref":"#/components/schemas/TikTokImage"},"type":["array","null"]},"duration":{"type":["number","null"]},"hasWatermark":{"type":["boolean","null"]},"hash":{"minLength":1,"type":["string","null"]},"height":{"type":["integer","null"]},"id":{"minLength":1,"type":["string","null"]},"previewThumbnails":{"items":{"$ref":"#/components/schemas/TikTokPreviewThumbnails"},"type":["array","null"]},"qualityLabel":{"minLength":1,"type":["string","null"]},"renditions":{"items":{"$ref":"#/components/schemas/TikTokRendition"},"type":["array","null"]},"size":{"type":["integer","null"]},"subtitles":{"items":{"$ref":"#/components/schemas/TikTokSubtitle"},"type":["array","null"]},"type":{"minLength":1,"type":["string","null"]},"url":{"format":"uri","minLength":1,"type":["string","null"]},"urls":{"items":{"minLength":1,"type":"string"},"type":["array","null"]},"width":{"type":["integer","null"]}},"required":["id","type","url","width","height","size","hash","duration","hasWatermark","qualityLabel","urls","renditions","covers","subtitles","previewThumbnails"],"type":"object"},"TikTokMusic":{"additionalProperties":false,"properties":{"album":{"minLength":1,"type":["string","null"]},"appleMusicSongId":{"minLength":1,"type":["string","null"]},"artistName":{"minLength":1,"type":["string","null"]},"artists":{"items":{"$ref":"#/components/schemas/TikTokProfileReference"},"type":["array","null"]},"audio":{"anyOf":[{"$ref":"#/components/schemas/TikTokAudio"},{"type":"null"}]},"beatData":{"anyOf":[{"$ref":"#/components/schemas/TikTokBeatData"},{"type":"null"}]},"chartContext":{"$ref":"#/components/schemas/TikTokMusicChartContext"},"classification":{"$ref":"#/components/schemas/TikTokMusicClassification"},"covers":{"items":{"$ref":"#/components/schemas/TikTokImage"},"type":["array","null"]},"createdAt":{"format":"date-time","minLength":1,"type":["string","null"]},"duration":{"type":["number","null"]},"durations":{"$ref":"#/components/schemas/TikTokMusicDurations"},"externalSongs":{"items":{"$ref":"#/components/schemas/TikTokUnspecified"},"type":["array","null"]},"grouping":{"$ref":"#/components/schemas/TikTokMusicGrouping"},"hasBehindTheSong":{"type":["boolean","null"]},"hasHumanVoice":{"type":["boolean","null"]},"hasMatchedMetadata":{"type":["boolean","null"]},"id":{"minLength":1,"type":"string"},"isAuthorArtist":{"type":["boolean","null"]},"isAuthorDeleted":{"type":["boolean","null"]},"isOriginal":{"type":["boolean","null"]},"isOriginalSound":{"type":["boolean","null"]},"isPgc":{"type":["boolean","null"]},"isPlayMusic":{"type":["boolean","null"]},"lyricAssets":{"items":{"$ref":"#/components/schemas/TikTokLyricAsset"},"type":["array","null"]},"matchedCatalogTrack":{"anyOf":[{"$ref":"#/components/schemas/TikTokMusicReference"},{"type":"null"}]},"matchedSong":{"anyOf":[{"$ref":"#/components/schemas/TikTokMatchedTrack"},{"type":"null"}]},"matchedSound":{"anyOf":[{"$ref":"#/components/schemas/TikTokMatchedTrack"},{"type":"null"}]},"metrics":{"$ref":"#/components/schemas/TikTokMusicMetrics"},"mid":{"minLength":1,"type":["string","null"]},"owner":{"anyOf":[{"$ref":"#/components/schemas/TikTokProfileReference"},{"type":"null"}]},"preview":{"$ref":"#/components/schemas/TikTokMusicPreview"},"recommendationStatusCode":{"type":["integer","null"]},"release":{"$ref":"#/components/schemas/TikTokMusicRelease"},"searchContext":{"$ref":"#/components/schemas/TikTokMusicSearchContext"},"similarTracks":{"items":{"$ref":"#/components/schemas/TikTokMusicReference"},"type":["array","null"]},"source":{"$ref":"#/components/schemas/TikTokMusicSource"},"streamingLinks":{"items":{"$ref":"#/components/schemas/TikTokStreamingLink"},"type":["array","null"]},"title":{"minLength":1,"type":["string","null"]},"url":{"format":"uri","minLength":1,"type":["string","null"]}},"required":["id","mid","title","artistName","album","url","duration","createdAt","isOriginal","isOriginalSound","isAuthorArtist","hasHumanVoice","isAuthorDeleted","isPgc","hasMatchedMetadata","recommendationStatusCode","isPlayMusic","owner","artists","metrics","audio","covers","beatData","durations","release","preview","matchedSong","matchedSound","classification","grouping","streamingLinks","lyricAssets","source","appleMusicSongId","searchContext","chartContext","matchedCatalogTrack","hasBehindTheSong","similarTracks","externalSongs"],"type":"object"},"TikTokMusicChartContext":{"additionalProperties":false,"properties":{"id":{"minLength":1,"type":["string","null"]},"position":{"type":["integer","null"]},"trendCode":{"type":["integer","null"]}},"required":["id","position","trendCode"],"type":"object"},"TikTokMusicClassification":{"additionalProperties":false,"properties":{"languageLabel":{"minLength":1,"type":["string","null"]},"styleCodes":{"items":{"type":"integer"},"type":["array","null"]},"themeCodes":{"items":{"type":"integer"},"type":["array","null"]},"themes":{"items":{"minLength":1,"type":"string"},"type":["array","null"]}},"required":["themes","themeCodes","styleCodes","languageLabel"],"type":"object"},"TikTokMusicContext":{"additionalProperties":false,"properties":{"label":{"minLength":1,"type":["string","null"]}},"required":["label"],"type":"object"},"TikTokMusicDurations":{"additionalProperties":false,"properties":{"shoot":{"type":["number","null"]},"video":{"type":["number","null"]}},"required":["shoot","video"],"type":"object"},"TikTokMusicGrouping":{"additionalProperties":false,"properties":{"groupIds":{"items":{"minLength":1,"type":"string"},"type":["array","null"]},"sameGroupId":{"minLength":1,"type":["string","null"]},"similarGroupId":{"minLength":1,"type":["string","null"]},"ugid":{"minLength":1,"type":["string","null"]}},"required":["sameGroupId","similarGroupId","ugid","groupIds"],"type":"object"},"TikTokMusicMetrics":{"additionalProperties":false,"properties":{"groupUses":{"type":["integer","null"]},"posts":{"type":["integer","null"]},"ugidUses":{"type":["integer","null"]}},"required":["posts","groupUses","ugidUses"],"type":"object"},"TikTokMusicPreview":{"additionalProperties":false,"properties":{"duration":{"type":["number","null"]},"endTime":{"type":["number","null"]},"startTime":{"type":["number","null"]}},"required":["startTime","endTime","duration"],"type":"object"},"TikTokMusicReference":{"additionalProperties":false,"properties":{"album":{"minLength":1,"type":["string","null"]},"appleMusicSongId":{"minLength":1,"type":["string","null"]},"artistName":{"minLength":1,"type":["string","null"]},"artists":{"items":{"$ref":"#/components/schemas/TikTokProfileReference"},"type":["array","null"]},"audio":{"anyOf":[{"$ref":"#/components/schemas/TikTokAudio"},{"type":"null"}]},"beatData":{"anyOf":[{"$ref":"#/components/schemas/TikTokBeatData"},{"type":"null"}]},"chartContext":{"$ref":"#/components/schemas/TikTokMusicChartContext"},"classification":{"$ref":"#/components/schemas/TikTokMusicClassification"},"covers":{"items":{"$ref":"#/components/schemas/TikTokImage"},"type":["array","null"]},"createdAt":{"format":"date-time","minLength":1,"type":["string","null"]},"duration":{"type":["number","null"]},"durations":{"$ref":"#/components/schemas/TikTokMusicDurations"},"externalSongs":{"items":{"$ref":"#/components/schemas/TikTokUnspecified"},"type":["array","null"]},"grouping":{"$ref":"#/components/schemas/TikTokMusicGrouping"},"hasBehindTheSong":{"type":["boolean","null"]},"hasHumanVoice":{"type":["boolean","null"]},"hasMatchedMetadata":{"type":["boolean","null"]},"id":{"minLength":1,"type":["string","null"]},"isAuthorArtist":{"type":["boolean","null"]},"isAuthorDeleted":{"type":["boolean","null"]},"isOriginal":{"type":["boolean","null"]},"isOriginalSound":{"type":["boolean","null"]},"isPgc":{"type":["boolean","null"]},"isPlayMusic":{"type":["boolean","null"]},"lyricAssets":{"items":{"$ref":"#/components/schemas/TikTokLyricAsset"},"type":["array","null"]},"matchedCatalogTrack":{"anyOf":[{"$ref":"#/components/schemas/TikTokMusicReference"},{"type":"null"}]},"matchedSong":{"anyOf":[{"$ref":"#/components/schemas/TikTokMatchedTrack"},{"type":"null"}]},"matchedSound":{"anyOf":[{"$ref":"#/components/schemas/TikTokMatchedTrack"},{"type":"null"}]},"metrics":{"$ref":"#/components/schemas/TikTokMusicMetrics"},"mid":{"minLength":1,"type":["string","null"]},"owner":{"anyOf":[{"$ref":"#/components/schemas/TikTokProfileReference"},{"type":"null"}]},"preview":{"$ref":"#/components/schemas/TikTokMusicPreview"},"recommendationStatusCode":{"type":["integer","null"]},"release":{"$ref":"#/components/schemas/TikTokMusicRelease"},"searchContext":{"$ref":"#/components/schemas/TikTokMusicSearchContext"},"similarTracks":{"items":{"$ref":"#/components/schemas/TikTokMusicReference"},"type":["array","null"]},"source":{"$ref":"#/components/schemas/TikTokMusicSource"},"streamingLinks":{"items":{"$ref":"#/components/schemas/TikTokStreamingLink"},"type":["array","null"]},"title":{"minLength":1,"type":["string","null"]},"url":{"format":"uri","minLength":1,"type":["string","null"]}},"required":["id","mid","title","artistName","album","url","duration","createdAt","isOriginal","isOriginalSound","isAuthorArtist","hasHumanVoice","isAuthorDeleted","isPgc","hasMatchedMetadata","recommendationStatusCode","isPlayMusic","owner","artists","metrics","audio","covers","beatData","durations","release","preview","matchedSong","matchedSound","classification","grouping","streamingLinks","lyricAssets","source","appleMusicSongId","searchContext","chartContext","matchedCatalogTrack","hasBehindTheSong","similarTracks","externalSongs"],"type":"object"},"TikTokMusicRelease":{"additionalProperties":false,"properties":{"date":{"minLength":1,"type":["string","null"]},"isNewRelease":{"type":["boolean","null"]}},"required":["isNewRelease","date"],"type":"object"},"TikTokMusicSearchContext":{"additionalProperties":false,"properties":{"description":{"minLength":1,"type":["string","null"]},"name":{"minLength":1,"type":["string","null"]},"relatedQuery":{"minLength":1,"type":["string","null"]}},"required":["name","description","relatedQuery"],"type":"object"},"TikTokMusicSource":{"additionalProperties":false,"properties":{"audioAssetId":{"minLength":1,"type":["string","null"]},"sourcePostId":{"minLength":1,"type":["string","null"]}},"required":["sourcePostId","audioAssetId"],"type":"object"},"TikTokOpeningHours":{"additionalProperties":false,"properties":{"endTime":{"minLength":1,"type":["string","null"]},"entries":{"items":{"$ref":"#/components/schemas/TikTokOpeningHoursEntry"},"type":["array","null"]},"startTime":{"minLength":1,"type":["string","null"]},"status":{"type":["boolean","null"]},"text":{"minLength":1,"type":["string","null"]}},"required":["entries","text","startTime","endTime","status"],"type":"object"},"TikTokOpeningHoursEntry":{"additionalProperties":false,"properties":{"dayCode":{"type":["integer","null"]},"text":{"minLength":1,"type":["string","null"]}},"required":["dayCode","text"],"type":"object"},"TikTokPageContinuation":{"additionalProperties":false,"properties":{"maxTime":{"type":["integer","null"]},"minTime":{"type":["integer","null"]},"offset":{"type":["integer","null"]},"pageToken":{"minLength":1,"type":["string","null"]}},"required":["pageToken","minTime","maxTime","offset"],"type":"object"},"TikTokPageMetadata":{"additionalProperties":false,"properties":{"chart":{"anyOf":[{"$ref":"#/components/schemas/TikTokChartMetadata"},{"type":"null"}]},"continuation":{"anyOf":[{"$ref":"#/components/schemas/TikTokPageContinuation"},{"type":"null"}]},"hasFilteredComments":{"type":["boolean","null"]},"hasMore":{"type":["boolean","null"]},"metrics":{"additionalProperties":false,"properties":{"comments":{"type":["integer","null"]},"followers":{"type":["integer","null"]},"following":{"type":["integer","null"]},"results":{"type":["integer","null"]}},"required":["comments","followers","following","results"],"type":"object"},"query":{"minLength":1,"type":["string","null"]}},"required":["hasMore","metrics","hasFilteredComments","query","chart","continuation"],"type":"object"},"TikTokPlaylist":{"additionalProperties":false,"properties":{"author":{"anyOf":[{"$ref":"#/components/schemas/TikTokProfileReference"},{"type":"null"}]},"creatorName":{"minLength":1,"type":["string","null"]},"id":{"minLength":1,"type":"string"},"index":{"type":["integer","null"]},"lastPostAddedAt":{"format":"date-time","minLength":1,"type":["string","null"]},"metrics":{"$ref":"#/components/schemas/TikTokPlaylistMetrics"},"name":{"minLength":1,"type":["string","null"]},"typeCode":{"type":["integer","null"]},"url":{"format":"uri","minLength":1,"type":["string","null"]}},"required":["id","name","url","creatorName","author","typeCode","index","lastPostAddedAt","metrics"],"type":"object"},"TikTokPlaylistMetrics":{"additionalProperties":false,"properties":{"plays":{"type":["integer","null"]},"posts":{"type":["integer","null"]}},"required":["posts","plays"],"type":"object"},"TikTokPlaylistReference":{"additionalProperties":false,"properties":{"author":{"anyOf":[{"$ref":"#/components/schemas/TikTokProfileReference"},{"type":"null"}]},"creatorName":{"minLength":1,"type":["string","null"]},"id":{"minLength":1,"type":["string","null"]},"index":{"type":["integer","null"]},"lastPostAddedAt":{"format":"date-time","minLength":1,"type":["string","null"]},"metrics":{"$ref":"#/components/schemas/TikTokPlaylistMetrics"},"name":{"minLength":1,"type":["string","null"]},"typeCode":{"type":["integer","null"]},"url":{"format":"uri","minLength":1,"type":["string","null"]}},"required":["id","name","url","creatorName","author","typeCode","index","lastPostAddedAt","metrics"],"type":"object"},"TikTokPost":{"additionalProperties":false,"properties":{"ai":{"$ref":"#/components/schemas/TikTokPostAI"},"audio":{"$ref":"#/components/schemas/TikTokPostAudio"},"author":{"anyOf":[{"$ref":"#/components/schemas/TikTokProfileReference"},{"type":"null"}]},"authorId":{"minLength":1,"type":["string","null"]},"caption":{"$ref":"#/components/schemas/TikTokPostCaption"},"collaborators":{"items":{"$ref":"#/components/schemas/TikTokCollaborator"},"type":["array","null"]},"commerce":{"$ref":"#/components/schemas/TikTokPostCommerce"},"cover":{"anyOf":[{"$ref":"#/components/schemas/TikTokImage"},{"type":"null"}]},"createdAt":{"format":"date-time","minLength":1,"type":"string"},"description":{"minLength":1,"type":["string","null"]},"effects":{"items":{"$ref":"#/components/schemas/TikTokEffectReference"},"type":["array","null"]},"entities":{"items":{"$ref":"#/components/schemas/TikTokTextEntity"},"type":["array","null"]},"extracted":{"$ref":"#/components/schemas/TikTokExtracted"},"hasDanmaku":{"type":["boolean","null"]},"hasPromotionalMusic":{"type":["boolean","null"]},"hashtags":{"items":{"$ref":"#/components/schemas/TikTokHashtagReference"},"type":"array"},"id":{"minLength":1,"type":"string"},"isAd":{"type":["boolean","null"]},"isMeme":{"type":["boolean","null"]},"isPaidContent":{"type":["boolean","null"]},"isPinned":{"type":["boolean","null"]},"isVr":{"type":["boolean","null"]},"language":{"minLength":1,"type":["string","null"]},"locations":{"items":{"$ref":"#/components/schemas/TikTokLocationReference"},"type":["array","null"]},"media":{"items":{"$ref":"#/components/schemas/TikTokMedia"},"type":"array"},"metrics":{"$ref":"#/components/schemas/TikTokPostMetrics"},"musicContext":{"$ref":"#/components/schemas/TikTokMusicContext"},"onScreenText":{"items":{"$ref":"#/components/schemas/TikTokUnspecified"},"type":["array","null"]},"paidCollectionId":{"minLength":1,"type":["string","null"]},"playlist":{"anyOf":[{"$ref":"#/components/schemas/TikTokPlaylistReference"},{"type":"null"}]},"region":{"minLength":1,"type":["string","null"]},"searchContext":{"$ref":"#/components/schemas/TikTokPostSearchContext"},"status":{"$ref":"#/components/schemas/TikTokPostStatus"},"stickers":{"items":{"$ref":"#/components/schemas/TikTokInteractionSticker"},"type":["array","null"]},"template":{"anyOf":[{"$ref":"#/components/schemas/TikTokPostTemplate"},{"type":"null"}]},"text":{"minLength":1,"type":["string","null"]},"title":{"minLength":1,"type":["string","null"]},"type":{"minLength":1,"type":["string","null"]},"url":{"format":"uri","minLength":1,"type":"string"}},"required":["id","type","url","text","title","description","extracted","region","language","createdAt","author","authorId","isAd","isPaidContent","isVr","hasPromotionalMusic","hasDanmaku","isPinned","isMeme","media","cover","metrics","status","ai","commerce","entities","hashtags","locations","caption","searchContext","collaborators","audio","template","paidCollectionId","onScreenText","playlist","effects","stickers","musicContext"],"type":"object"},"TikTokPostAI":{"additionalProperties":false,"properties":{"isCreatedByAi":{"type":["boolean","null"]},"labelType":{"type":["integer","null"]}},"required":["isCreatedByAi","labelType"],"type":"object"},"TikTokPostAudio":{"additionalProperties":false,"properties":{"addedTrack":{"anyOf":[{"$ref":"#/components/schemas/TikTokMusicReference"},{"type":"null"}]},"addedVolume":{"type":["number","null"]},"endTime":{"type":["number","null"]},"originalVolume":{"type":["number","null"]},"startTime":{"type":["number","null"]},"track":{"anyOf":[{"$ref":"#/components/schemas/TikTokMusicReference"},{"type":"null"}]},"usesFullSong":{"type":["boolean","null"]}},"required":["track","addedTrack","startTime","endTime","originalVolume","addedVolume","usesFullSong"],"type":"object"},"TikTokPostCaption":{"additionalProperties":false,"properties":{"entities":{"items":{"$ref":"#/components/schemas/TikTokTextEntity"},"type":["array","null"]},"markup":{"minLength":1,"type":["string","null"]}},"required":["markup","entities"],"type":"object"},"TikTokPostCommerce":{"additionalProperties":false,"properties":{"brandedContentType":{"type":["integer","null"]},"disclosureLabel":{"minLength":1,"type":["string","null"]},"isDiversionAd":{"type":["boolean","null"]},"isEcommerce":{"type":["boolean","null"]},"metrics":{"$ref":"#/components/schemas/TikTokCommerceMetrics"},"products":{"items":{"$ref":"#/components/schemas/TikTokProduct"},"type":["array","null"]},"sellerIds":{"items":{"minLength":1,"type":"string"},"type":["array","null"]}},"required":["brandedContentType","isDiversionAd","disclosureLabel","metrics","isEcommerce","sellerIds","products"],"type":"object"},"TikTokPostMetrics":{"additionalProperties":false,"properties":{"comments":{"type":["integer","null"]},"downloads":{"type":["integer","null"]},"likes":{"type":["integer","null"]},"reposts":{"type":["integer","null"]},"saves":{"type":["integer","null"]},"shares":{"type":["integer","null"]},"views":{"type":["integer","null"]},"whatsapp":{"$ref":"#/components/schemas/TikTokWhatsAppMetrics"}},"required":["likes","comments","views","saves","shares","downloads","reposts","whatsapp"],"type":"object"},"TikTokPostReference":{"additionalProperties":false,"properties":{"ai":{"$ref":"#/components/schemas/TikTokPostAI"},"audio":{"$ref":"#/components/schemas/TikTokPostAudio"},"author":{"anyOf":[{"$ref":"#/components/schemas/TikTokProfileReference"},{"type":"null"}]},"authorId":{"minLength":1,"type":["string","null"]},"caption":{"$ref":"#/components/schemas/TikTokPostCaption"},"collaborators":{"items":{"$ref":"#/components/schemas/TikTokCollaborator"},"type":["array","null"]},"commerce":{"$ref":"#/components/schemas/TikTokPostCommerce"},"cover":{"anyOf":[{"$ref":"#/components/schemas/TikTokImage"},{"type":"null"}]},"createdAt":{"format":"date-time","minLength":1,"type":["string","null"]},"description":{"minLength":1,"type":["string","null"]},"effects":{"items":{"$ref":"#/components/schemas/TikTokEffectReference"},"type":["array","null"]},"entities":{"items":{"$ref":"#/components/schemas/TikTokTextEntity"},"type":["array","null"]},"extracted":{"$ref":"#/components/schemas/TikTokExtracted"},"hasDanmaku":{"type":["boolean","null"]},"hasPromotionalMusic":{"type":["boolean","null"]},"hashtags":{"items":{"$ref":"#/components/schemas/TikTokHashtagReference"},"type":["array","null"]},"id":{"minLength":1,"type":["string","null"]},"isAd":{"type":["boolean","null"]},"isMeme":{"type":["boolean","null"]},"isPaidContent":{"type":["boolean","null"]},"isPinned":{"type":["boolean","null"]},"isVr":{"type":["boolean","null"]},"language":{"minLength":1,"type":["string","null"]},"locations":{"items":{"$ref":"#/components/schemas/TikTokLocationReference"},"type":["array","null"]},"media":{"items":{"$ref":"#/components/schemas/TikTokMedia"},"type":["array","null"]},"metrics":{"$ref":"#/components/schemas/TikTokPostMetrics"},"musicContext":{"$ref":"#/components/schemas/TikTokMusicContext"},"onScreenText":{"items":{"$ref":"#/components/schemas/TikTokUnspecified"},"type":["array","null"]},"paidCollectionId":{"minLength":1,"type":["string","null"]},"playlist":{"anyOf":[{"$ref":"#/components/schemas/TikTokPlaylistReference"},{"type":"null"}]},"region":{"minLength":1,"type":["string","null"]},"searchContext":{"$ref":"#/components/schemas/TikTokPostSearchContext"},"status":{"$ref":"#/components/schemas/TikTokPostStatus"},"stickers":{"items":{"$ref":"#/components/schemas/TikTokInteractionSticker"},"type":["array","null"]},"template":{"anyOf":[{"$ref":"#/components/schemas/TikTokPostTemplate"},{"type":"null"}]},"text":{"minLength":1,"type":["string","null"]},"title":{"minLength":1,"type":["string","null"]},"type":{"minLength":1,"type":["string","null"]},"url":{"format":"uri","minLength":1,"type":["string","null"]}},"required":["id","type","url","text","title","description","extracted","region","language","createdAt","author","authorId","isAd","isPaidContent","isVr","hasPromotionalMusic","hasDanmaku","isPinned","isMeme","media","cover","metrics","status","ai","commerce","entities","hashtags","locations","caption","searchContext","collaborators","audio","template","paidCollectionId","onScreenText","playlist","effects","stickers","musicContext"],"type":"object"},"TikTokPostSearchContext":{"additionalProperties":false,"properties":{"description":{"minLength":1,"type":["string","null"]},"highlights":{"items":{"$ref":"#/components/schemas/TikTokSearchHighlight"},"type":["array","null"]}},"required":["description","highlights"],"type":"object"},"TikTokPostStatus":{"additionalProperties":false,"properties":{"isDeleted":{"type":["boolean","null"]},"isProhibited":{"type":["boolean","null"]},"isUnderReview":{"type":["boolean","null"]},"privacyCode":{"type":["integer","null"]},"reviewedCode":{"type":["integer","null"]}},"required":["isDeleted","isProhibited","privacyCode","isUnderReview","reviewedCode"],"type":"object"},"TikTokPostTemplate":{"additionalProperties":false,"properties":{"authorName":{"minLength":1,"type":["string","null"]},"description":{"minLength":1,"type":["string","null"]},"duration":{"type":["number","null"]},"id":{"minLength":1,"type":["string","null"]},"metrics":{"$ref":"#/components/schemas/TikTokTemplateMetrics"},"musicId":{"minLength":1,"type":["string","null"]}},"required":["id","authorName","description","duration","musicId","metrics"],"type":"object"},"TikTokPreviewThumbnails":{"additionalProperties":false,"properties":{"columns":{"type":["integer","null"]},"duration":{"type":["number","null"]},"format":{"minLength":1,"type":["string","null"]},"imageCount":{"type":["integer","null"]},"imageIds":{"items":{"minLength":1,"type":"string"},"type":["array","null"]},"interval":{"type":["number","null"]},"rows":{"type":["integer","null"]},"tileHeight":{"type":["integer","null"]},"tileWidth":{"type":["integer","null"]},"urls":{"items":{"minLength":1,"type":"string"},"type":["array","null"]}},"required":["duration","interval","imageCount","columns","rows","tileWidth","tileHeight","format","urls","imageIds"],"type":"object"},"TikTokProduct":{"additionalProperties":false,"properties":{"categories":{"items":{"$ref":"#/components/schemas/TikTokProductCategory"},"type":["array","null"]},"cover":{"anyOf":[{"$ref":"#/components/schemas/TikTokImage"},{"type":"null"}]},"disclosureLabel":{"minLength":1,"type":["string","null"]},"id":{"minLength":1,"type":["string","null"]},"images":{"items":{"$ref":"#/components/schemas/TikTokImage"},"type":["array","null"]},"inShop":{"type":["boolean","null"]},"isPlatformProduct":{"type":["boolean","null"]},"label":{"minLength":1,"type":["string","null"]},"name":{"minLength":1,"type":["string","null"]},"platformCode":{"type":["integer","null"]},"pricing":{"$ref":"#/components/schemas/TikTokProductPricing"},"sellerId":{"minLength":1,"type":["string","null"]},"shortName":{"minLength":1,"type":["string","null"]},"skus":{"items":{"$ref":"#/components/schemas/TikTokProductSKU"},"type":["array","null"]},"source":{"minLength":1,"type":["string","null"]},"statusCode":{"type":["integer","null"]}},"required":["id","name","shortName","source","platformCode","statusCode","inShop","isPlatformProduct","sellerId","pricing","images","cover","skus","categories","disclosureLabel","label"],"type":"object"},"TikTokProductCategory":{"additionalProperties":false,"properties":{"id":{"minLength":1,"type":["string","null"]},"isLeaf":{"type":["boolean","null"]},"level":{"type":["integer","null"]},"name":{"minLength":1,"type":["string","null"]},"parentId":{"minLength":1,"type":["string","null"]}},"required":["id","name","level","isLeaf","parentId"],"type":"object"},"TikTokProductPricing":{"additionalProperties":false,"properties":{"currency":{"minLength":1,"type":["string","null"]},"marketPrice":{"type":["integer","null"]},"price":{"type":["integer","null"]}},"required":["price","marketPrice","currency"],"type":"object"},"TikTokProductSKU":{"additionalProperties":false,"properties":{"externalId":{"minLength":1,"type":["string","null"]},"externalProductId":{"minLength":1,"type":["string","null"]},"id":{"minLength":1,"type":["string","null"]}},"required":["id","externalId","externalProductId"],"type":"object"},"TikTokProfile":{"additionalProperties":false,"properties":{"accountType":{"type":["integer","null"]},"avatar":{"anyOf":[{"$ref":"#/components/schemas/TikTokImage"},{"type":"null"}]},"bio":{"minLength":1,"type":["string","null"]},"category":{"minLength":1,"type":["string","null"]},"commerce":{"additionalProperties":false,"properties":{"hasLiveCommerce":{"type":["boolean","null"]},"hasNewProducts":{"type":["boolean","null"]},"level":{"type":["integer","null"]}},"required":["level","hasLiveCommerce","hasNewProducts"],"type":"object"},"createdAt":{"format":"date-time","minLength":1,"type":["string","null"]},"displayName":{"minLength":1,"type":["string","null"]},"extracted":{"$ref":"#/components/schemas/TikTokExtracted"},"handle":{"minLength":1,"type":"string"},"id":{"minLength":1,"type":"string"},"isAdVirtual":{"type":["boolean","null"]},"isCanceled":{"type":["boolean","null"]},"isDisciplineMember":{"type":["boolean","null"]},"isEffectArtist":{"type":["boolean","null"]},"isPrivate":{"type":["boolean","null"]},"isStar":{"type":["boolean","null"]},"isVerified":{"type":["boolean","null"]},"language":{"minLength":1,"type":["string","null"]},"metrics":{"$ref":"#/components/schemas/TikTokProfileMetrics"},"music":{"additionalProperties":false,"properties":{"metrics":{"additionalProperties":false,"properties":{"likes":{"type":["integer","null"]},"tracks":{"type":["integer","null"]},"uses":{"type":["integer","null"]}},"required":["tracks","uses","likes"],"type":"object"},"newReleaseIds":{"items":{"minLength":1,"type":"string"},"type":["array","null"]}},"required":["metrics","newReleaseIds"],"type":"object"},"predictions":{"additionalProperties":false,"properties":{"ageGroup":{"minLength":1,"type":["string","null"]}},"required":["ageGroup"],"type":"object"},"privacy":{"additionalProperties":false,"properties":{"followingVisibility":{"type":["integer","null"]}},"required":["followingVisibility"],"type":"object"},"regionCode":{"minLength":1,"type":["string","null"]},"searchContext":{"additionalProperties":false,"properties":{"description":{"minLength":1,"type":["string","null"]},"name":{"minLength":1,"type":["string","null"]},"nameField":{"minLength":1,"type":["string","null"]}},"required":["description","name","nameField"],"type":"object"},"secUid":{"minLength":1,"type":["string","null"]},"socialLinks":{"items":{"$ref":"#/components/schemas/TikTokSocialLink"},"type":["array","null"]},"stories":{"additionalProperties":false,"properties":{"changedAt":{"format":"date-time","minLength":1,"type":["string","null"]},"items":{"items":{"$ref":"#/components/schemas/TikTokStoryReference"},"type":["array","null"]},"metrics":{"additionalProperties":false,"properties":{"countsByPostType":{"items":{"$ref":"#/components/schemas/TikTokStoryCount"},"type":["array","null"]}},"required":["countsByPostType"],"type":"object"}},"required":["items","changedAt","metrics"],"type":"object"},"storyStatus":{"type":["integer","null"]},"url":{"format":"uri","minLength":1,"type":"string"},"verification":{"additionalProperties":false,"properties":{"badgeType":{"type":["integer","null"]},"customLabel":{"minLength":1,"type":["string","null"]},"label":{"minLength":1,"type":["string","null"]},"type":{"type":["integer","null"]}},"required":["type","badgeType","label","customLabel"],"type":"object"}},"required":["id","secUid","handle","displayName","bio","extracted","url","createdAt","avatar","isPrivate","isVerified","accountType","isEffectArtist","isAdVirtual","isStar","storyStatus","isDisciplineMember","isCanceled","regionCode","language","category","verification","metrics","commerce","privacy","music","predictions","searchContext","socialLinks","stories"],"type":"object"},"TikTokProfileMetrics":{"additionalProperties":false,"properties":{"followers":{"type":["integer","null"]},"following":{"type":["integer","null"]},"likedPosts":{"type":["integer","null"]},"likes":{"type":["integer","null"]},"posts":{"type":["integer","null"]},"visiblePosts":{"type":["integer","null"]}},"required":["followers","following","posts","visiblePosts","likes","likedPosts"],"type":"object"},"TikTokProfileReference":{"additionalProperties":false,"properties":{"accountType":{"type":["integer","null"]},"avatar":{"anyOf":[{"$ref":"#/components/schemas/TikTokImage"},{"type":"null"}]},"bio":{"minLength":1,"type":["string","null"]},"category":{"minLength":1,"type":["string","null"]},"commerce":{"additionalProperties":false,"properties":{"hasLiveCommerce":{"type":["boolean","null"]},"hasNewProducts":{"type":["boolean","null"]},"level":{"type":["integer","null"]}},"required":["level","hasLiveCommerce","hasNewProducts"],"type":"object"},"createdAt":{"format":"date-time","minLength":1,"type":["string","null"]},"displayName":{"minLength":1,"type":["string","null"]},"extracted":{"$ref":"#/components/schemas/TikTokExtracted"},"handle":{"minLength":1,"type":["string","null"]},"id":{"minLength":1,"type":["string","null"]},"isAdVirtual":{"type":["boolean","null"]},"isCanceled":{"type":["boolean","null"]},"isDisciplineMember":{"type":["boolean","null"]},"isEffectArtist":{"type":["boolean","null"]},"isPrivate":{"type":["boolean","null"]},"isStar":{"type":["boolean","null"]},"isVerified":{"type":["boolean","null"]},"language":{"minLength":1,"type":["string","null"]},"metrics":{"$ref":"#/components/schemas/TikTokProfileMetrics"},"music":{"additionalProperties":false,"properties":{"metrics":{"additionalProperties":false,"properties":{"likes":{"type":["integer","null"]},"tracks":{"type":["integer","null"]},"uses":{"type":["integer","null"]}},"required":["tracks","uses","likes"],"type":"object"},"newReleaseIds":{"items":{"minLength":1,"type":"string"},"type":["array","null"]}},"required":["metrics","newReleaseIds"],"type":"object"},"predictions":{"additionalProperties":false,"properties":{"ageGroup":{"minLength":1,"type":["string","null"]}},"required":["ageGroup"],"type":"object"},"privacy":{"additionalProperties":false,"properties":{"followingVisibility":{"type":["integer","null"]}},"required":["followingVisibility"],"type":"object"},"regionCode":{"minLength":1,"type":["string","null"]},"searchContext":{"additionalProperties":false,"properties":{"description":{"minLength":1,"type":["string","null"]},"name":{"minLength":1,"type":["string","null"]},"nameField":{"minLength":1,"type":["string","null"]}},"required":["description","name","nameField"],"type":"object"},"secUid":{"minLength":1,"type":["string","null"]},"socialLinks":{"items":{"$ref":"#/components/schemas/TikTokSocialLink"},"type":["array","null"]},"stories":{"additionalProperties":false,"properties":{"changedAt":{"format":"date-time","minLength":1,"type":["string","null"]},"items":{"items":{"$ref":"#/components/schemas/TikTokStoryReference"},"type":["array","null"]},"metrics":{"additionalProperties":false,"properties":{"countsByPostType":{"items":{"$ref":"#/components/schemas/TikTokStoryCount"},"type":["array","null"]}},"required":["countsByPostType"],"type":"object"}},"required":["items","changedAt","metrics"],"type":"object"},"storyStatus":{"type":["integer","null"]},"url":{"format":"uri","minLength":1,"type":["string","null"]},"verification":{"additionalProperties":false,"properties":{"badgeType":{"type":["integer","null"]},"customLabel":{"minLength":1,"type":["string","null"]},"label":{"minLength":1,"type":["string","null"]},"type":{"type":["integer","null"]}},"required":["type","badgeType","label","customLabel"],"type":"object"}},"required":["id","secUid","handle","displayName","bio","extracted","url","createdAt","avatar","isPrivate","isVerified","accountType","isEffectArtist","isAdVirtual","isStar","storyStatus","isDisciplineMember","isCanceled","regionCode","language","category","verification","metrics","commerce","privacy","music","predictions","searchContext","socialLinks","stories"],"type":"object"},"TikTokRatingSource":{"additionalProperties":false,"properties":{"code":{"type":["integer","null"]},"name":{"minLength":1,"type":["string","null"]}},"required":["code","name"],"type":"object"},"TikTokRendition":{"additionalProperties":false,"properties":{"bitrate":{"type":["integer","null"]},"codecCode":{"type":["integer","null"]},"frameRate":{"type":["number","null"]},"hash":{"minLength":1,"type":["string","null"]},"height":{"type":["integer","null"]},"id":{"minLength":1,"type":["string","null"]},"isBytevc1":{"type":["boolean","null"]},"label":{"minLength":1,"type":["string","null"]},"qualityCode":{"type":["integer","null"]},"qualityLabel":{"minLength":1,"type":["string","null"]},"role":{"minLength":1,"type":["string","null"]},"size":{"type":["integer","null"]},"url":{"format":"uri","minLength":1,"type":["string","null"]},"urls":{"items":{"minLength":1,"type":"string"},"type":["array","null"]},"width":{"type":["integer","null"]}},"required":["id","url","width","height","size","hash","role","label","bitrate","frameRate","isBytevc1","codecCode","qualityLabel","qualityCode","urls"],"type":"object"},"TikTokSearchHighlight":{"additionalProperties":false,"properties":{"field":{"minLength":1,"type":["string","null"]},"ranges":{"items":{"$ref":"#/components/schemas/TikTokTextRange"},"type":["array","null"]}},"required":["field","ranges"],"type":"object"},"TikTokServiceCategory":{"additionalProperties":false,"properties":{"code":{"type":["integer","null"]},"name":{"minLength":1,"type":["string","null"]}},"required":["name","code"],"type":"object"},"TikTokSocialLink":{"additionalProperties":false,"properties":{"displayName":{"minLength":1,"type":["string","null"]},"handle":{"minLength":1,"type":["string","null"]},"id":{"minLength":1,"type":["string","null"]},"platform":{"minLength":1,"type":["string","null"]},"url":{"format":"uri","minLength":1,"type":["string","null"]}},"required":["platform","id","handle","displayName","url"],"type":"object"},"TikTokStickerPosition":{"additionalProperties":false,"properties":{"endTime":{"type":["number","null"]},"height":{"type":["number","null"]},"isRelative":{"type":["boolean","null"]},"rotation":{"type":["number","null"]},"scale":{"type":["number","null"]},"startTime":{"type":["number","null"]},"width":{"type":["number","null"]},"x":{"type":["number","null"]},"y":{"type":["number","null"]}},"required":["x","y","width","height","rotation","scale","isRelative","startTime","endTime"],"type":"object"},"TikTokStoryCount":{"additionalProperties":false,"properties":{"count":{"type":["integer","null"]},"postTypeCode":{"type":["integer","null"]}},"required":["postTypeCode","count"],"type":"object"},"TikTokStoryReference":{"additionalProperties":false,"properties":{"expiresAt":{"format":"date-time","minLength":1,"type":["string","null"]},"id":{"minLength":1,"type":["string","null"]},"mediaTypeCode":{"type":["integer","null"]},"postTypeCode":{"type":["integer","null"]}},"required":["id","mediaTypeCode","postTypeCode","expiresAt"],"type":"object"},"TikTokStreamingLink":{"additionalProperties":false,"properties":{"platformCode":{"type":["integer","null"]},"songId":{"minLength":1,"type":["string","null"]}},"required":["platformCode","songId"],"type":"object"},"TikTokSubtitle":{"additionalProperties":false,"properties":{"expiresAt":{"format":"date-time","minLength":1,"type":["string","null"]},"format":{"minLength":1,"type":["string","null"]},"hash":{"minLength":1,"type":["string","null"]},"id":{"minLength":1,"type":["string","null"]},"isAutoGenerated":{"type":["boolean","null"]},"isOriginal":{"type":["boolean","null"]},"language":{"minLength":1,"type":["string","null"]},"locale":{"minLength":1,"type":["string","null"]},"size":{"type":["integer","null"]},"url":{"format":"uri","minLength":1,"type":["string","null"]},"urls":{"items":{"minLength":1,"type":"string"},"type":["array","null"]},"version":{"minLength":1,"type":["string","null"]}},"required":["id","url","size","hash","format","language","locale","isAutoGenerated","isOriginal","version","expiresAt","urls"],"type":"object"},"TikTokTemplateMetrics":{"additionalProperties":false,"properties":{"clips":{"type":["integer","null"]}},"required":["clips"],"type":"object"},"TikTokTextEntity":{"additionalProperties":false,"properties":{"end":{"type":["integer","null"]},"hashtag":{"anyOf":[{"$ref":"#/components/schemas/TikTokHashtagReference"},{"type":"null"}]},"start":{"type":["integer","null"]},"tagId":{"minLength":1,"type":["string","null"]},"type":{"minLength":1,"type":["string","null"]},"typeCode":{"type":["integer","null"]},"user":{"anyOf":[{"$ref":"#/components/schemas/TikTokProfileReference"},{"type":"null"}]}},"required":["type","typeCode","start","end","tagId","user","hashtag"],"type":"object"},"TikTokTextRange":{"additionalProperties":false,"properties":{"end":{"type":["integer","null"]},"start":{"type":["integer","null"]}},"required":["start","end"],"type":"object"},"TikTokUnspecified":{"additionalProperties":false,"properties":{},"type":"object"},"TikTokVolumeInfo":{"additionalProperties":false,"properties":{"loudness":{"type":["number","null"]},"loudnessRange":{"type":["number","null"]},"loudnessRangeEnd":{"type":["number","null"]},"loudnessRangeStart":{"type":["number","null"]},"maxVolume":{"type":["number","null"]},"maximumMomentaryLoudness":{"type":["number","null"]},"maximumShortTermLoudness":{"type":["number","null"]},"meanVolume":{"type":["number","null"]},"peak":{"type":["number","null"]},"version":{"type":["number","null"]}},"required":["loudness","peak","loudnessRange","loudnessRangeStart","loudnessRangeEnd","maximumMomentaryLoudness","maximumShortTermLoudness","version","maxVolume","meanVolume"],"type":"object"},"TikTokWhatsAppMetrics":{"additionalProperties":false,"properties":{"shares":{"type":["integer","null"]}},"required":["shares"],"type":"object"},"TwitterAppMetrics":{"additionalProperties":false,"properties":{"rating":{"type":["number","null"]},"ratings":{"type":["integer","null"]}},"required":["rating","ratings"],"type":"object"},"TwitterArticle":{"additionalProperties":false,"properties":{"cover":{"anyOf":[{"$ref":"#/components/schemas/TwitterMedia"},{"type":"null"}]},"id":{"minLength":1,"type":["string","null"]},"previewText":{"minLength":1,"type":["string","null"]},"title":{"minLength":1,"type":["string","null"]}},"required":["id","title","previewText","cover"],"type":"object"},"TwitterAspectRatio":{"additionalProperties":false,"properties":{"height":{"type":"integer"},"width":{"type":"integer"}},"required":["width","height"],"type":"object"},"TwitterBroadcast":{"additionalProperties":false,"properties":{"broadcaster":{"anyOf":[{"$ref":"#/components/schemas/TwitterBroadcaster"},{"type":"null"}]},"height":{"type":["integer","null"]},"id":{"minLength":1,"type":["string","null"]},"isHighLatency":{"type":["boolean","null"]},"media":{"anyOf":[{"$ref":"#/components/schemas/TwitterBroadcastMedia"},{"type":"null"}]},"orientationCode":{"type":["integer","null"]},"replayEditedStartTime":{"minLength":1,"type":["string","null"]},"scheduledStartAt":{"format":"date-time","minLength":1,"type":["string","null"]},"source":{"minLength":1,"type":["string","null"]},"state":{"minLength":1,"type":["string","null"]},"title":{"minLength":1,"type":["string","null"]},"url":{"format":"uri","minLength":1,"type":["string","null"]},"width":{"type":["integer","null"]}},"required":["id","url","title","source","state","isHighLatency","width","height","orientationCode","scheduledStartAt","media","broadcaster","replayEditedStartTime"],"type":"object"},"TwitterBroadcastMedia":{"additionalProperties":false,"properties":{"id":{"minLength":1,"type":["string","null"]},"key":{"minLength":1,"type":["string","null"]}},"required":["id","key"],"type":"object"},"TwitterBroadcaster":{"additionalProperties":false,"properties":{"displayName":{"minLength":1,"type":["string","null"]},"handle":{"minLength":1,"type":["string","null"]},"id":{"minLength":1,"type":["string","null"]}},"required":["id","handle","displayName"],"type":"object"},"TwitterCard":{"additionalProperties":false,"properties":{"apps":{"items":{"$ref":"#/components/schemas/TwitterCardApp"},"type":["array","null"]},"broadcast":{"anyOf":[{"$ref":"#/components/schemas/TwitterBroadcast"},{"type":"null"}]},"components":{"items":{"$ref":"#/components/schemas/TwitterCardComponent"},"type":["array","null"]},"description":{"minLength":1,"type":["string","null"]},"destinations":{"items":{"$ref":"#/components/schemas/TwitterCardDestination"},"type":["array","null"]},"displayUrl":{"format":"uri","minLength":1,"type":["string","null"]},"domain":{"minLength":1,"type":["string","null"]},"event":{"anyOf":[{"$ref":"#/components/schemas/TwitterEvent"},{"type":"null"}]},"imageAltText":{"items":{"$ref":"#/components/schemas/TwitterImageAltText"},"type":["array","null"]},"images":{"items":{"$ref":"#/components/schemas/TwitterImage"},"type":["array","null"]},"layoutType":{"minLength":1,"type":["string","null"]},"media":{"items":{"$ref":"#/components/schemas/TwitterMedia"},"type":["array","null"]},"mediaType":{"minLength":1,"type":["string","null"]},"poll":{"anyOf":[{"$ref":"#/components/schemas/TwitterPoll"},{"type":"null"}]},"profiles":{"items":{"$ref":"#/components/schemas/TwitterProfileReference"},"type":["array","null"]},"publisherId":{"minLength":1,"type":["string","null"]},"title":{"minLength":1,"type":["string","null"]},"type":{"minLength":1,"type":["string","null"]},"url":{"format":"uri","minLength":1,"type":["string","null"]}},"required":["type","url","profiles","title","description","domain","displayUrl","mediaType","broadcast","event","publisherId","images","imageAltText","poll","layoutType","components","destinations","media","apps"],"type":"object"},"TwitterCardApp":{"additionalProperties":false,"properties":{"category":{"anyOf":[{"$ref":"#/components/schemas/TwitterCardText"},{"type":"null"}]},"countryCode":{"minLength":1,"type":["string","null"]},"description":{"anyOf":[{"$ref":"#/components/schemas/TwitterCardText"},{"type":"null"}]},"groupId":{"minLength":1,"type":["string","null"]},"hasInAppPurchases":{"type":["boolean","null"]},"iconKey":{"minLength":1,"type":["string","null"]},"id":{"minLength":1,"type":["string","null"]},"isEditorsChoice":{"type":["boolean","null"]},"isFree":{"type":["boolean","null"]},"metrics":{"anyOf":[{"$ref":"#/components/schemas/TwitterAppMetrics"},{"type":"null"}]},"resolvedUrl":{"format":"uri","minLength":1,"type":["string","null"]},"sizeBytes":{"type":["integer","null"]},"title":{"anyOf":[{"$ref":"#/components/schemas/TwitterCardText"},{"type":"null"}]},"type":{"minLength":1,"type":["string","null"]},"url":{"format":"uri","minLength":1,"type":["string","null"]}},"required":["groupId","id","type","countryCode","url","resolvedUrl","isEditorsChoice","isFree","iconKey","sizeBytes","hasInAppPurchases","category","title","description","metrics"],"type":"object"},"TwitterCardButton":{"additionalProperties":false,"properties":{"action":{"minLength":1,"type":["string","null"]},"destinationId":{"minLength":1,"type":["string","null"]},"style":{"minLength":1,"type":["string","null"]},"type":{"minLength":1,"type":["string","null"]}},"required":["action","style","type","destinationId"],"type":"object"},"TwitterCardComponent":{"additionalProperties":false,"properties":{"appGroupId":{"minLength":1,"type":["string","null"]},"buttons":{"items":{"$ref":"#/components/schemas/TwitterCardButton"},"type":["array","null"]},"destinationId":{"minLength":1,"type":["string","null"]},"id":{"minLength":1,"type":["string","null"]},"media":{"items":{"$ref":"#/components/schemas/TwitterCardMediaRef"},"type":["array","null"]},"mediaKey":{"minLength":1,"type":["string","null"]},"subtitle":{"anyOf":[{"$ref":"#/components/schemas/TwitterCardText"},{"type":"null"}]},"title":{"anyOf":[{"$ref":"#/components/schemas/TwitterCardText"},{"type":"null"}]},"type":{"minLength":1,"type":["string","null"]}},"required":["id","type","destinationId","mediaKey","appGroupId","title","subtitle","media","buttons"],"type":"object"},"TwitterCardDestination":{"additionalProperties":false,"properties":{"appGroupId":{"minLength":1,"type":["string","null"]},"displayUrl":{"format":"uri","minLength":1,"type":["string","null"]},"id":{"minLength":1,"type":["string","null"]},"mediaKey":{"minLength":1,"type":["string","null"]},"type":{"minLength":1,"type":["string","null"]},"url":{"format":"uri","minLength":1,"type":["string","null"]}},"required":["id","type","mediaKey","appGroupId","url","displayUrl"],"type":"object"},"TwitterCardMediaRef":{"additionalProperties":false,"properties":{"destinationId":{"minLength":1,"type":["string","null"]},"key":{"minLength":1,"type":["string","null"]}},"required":["key","destinationId"],"type":"object"},"TwitterCardText":{"additionalProperties":false,"properties":{"isRightToLeft":{"type":["boolean","null"]},"text":{"minLength":1,"type":["string","null"]}},"required":["text","isRightToLeft"],"type":"object"},"TwitterColor":{"additionalProperties":false,"properties":{"percentage":{"type":"number"},"rgb":{"$ref":"#/components/schemas/TwitterRGB"}},"required":["percentage","rgb"],"type":"object"},"TwitterCommunityNote":{"additionalProperties":false,"properties":{"id":{"minLength":1,"type":["string","null"]},"presentation":{"anyOf":[{"$ref":"#/components/schemas/TwitterNotePresentation"},{"type":"null"}]},"preview":{"anyOf":[{"$ref":"#/components/schemas/TwitterRichText"},{"type":"null"}]},"shortTitle":{"minLength":1,"type":["string","null"]},"summary":{"anyOf":[{"$ref":"#/components/schemas/TwitterRichText"},{"type":"null"}]},"title":{"minLength":1,"type":["string","null"]},"url":{"format":"uri","minLength":1,"type":["string","null"]}},"required":["id","url","title","shortTitle","summary","preview","presentation"],"type":"object"},"TwitterConversationContext":{"additionalProperties":false,"properties":{"ancestors":{"items":{"$ref":"#/components/schemas/TwitterPostReference"},"type":["array","null"]},"otherPosts":{"items":{"$ref":"#/components/schemas/TwitterPostReference"},"type":["array","null"]},"requestedPost":{"anyOf":[{"$ref":"#/components/schemas/TwitterPostReference"},{"type":"null"}]}},"required":["requestedPost","ancestors","otherPosts"],"type":"object"},"TwitterEdit":{"additionalProperties":false,"properties":{"editableUntil":{"minLength":1,"type":["string","null"]},"historyIds":{"items":{"minLength":1,"type":"string"},"type":["array","null"]},"initialPostId":{"minLength":1,"type":["string","null"]},"remaining":{"type":["integer","null"]}},"required":["historyIds","editableUntil","remaining","initialPostId"],"type":"object"},"TwitterEntity":{"additionalProperties":false,"properties":{"displayName":{"minLength":1,"type":["string","null"]},"displayUrl":{"format":"uri","minLength":1,"type":["string","null"]},"handle":{"minLength":1,"type":["string","null"]},"id":{"minLength":1,"type":["string","null"]},"mediaId":{"minLength":1,"type":["string","null"]},"range":{"anyOf":[{"$ref":"#/components/schemas/TwitterRange"},{"type":"null"}]},"shortUrl":{"format":"uri","minLength":1,"type":["string","null"]},"text":{"minLength":1,"type":["string","null"]},"type":{"minLength":1,"type":["string","null"]},"url":{"format":"uri","minLength":1,"type":["string","null"]}},"required":["type","range","shortUrl","url","displayUrl","text","handle","id","displayName","mediaId"],"type":"object"},"TwitterEvent":{"additionalProperties":false,"properties":{"category":{"minLength":1,"type":["string","null"]},"id":{"minLength":1,"type":["string","null"]},"subtitle":{"minLength":1,"type":["string","null"]},"timelineId":{"minLength":1,"type":["string","null"]},"title":{"minLength":1,"type":["string","null"]}},"required":["id","title","subtitle","category","timelineId"],"type":"object"},"TwitterExtracted":{"additionalProperties":false,"properties":{"emails":{"items":{"minLength":1,"type":"string"},"type":["array","null"]},"handles":{"items":{"$ref":"#/components/schemas/TwitterExtractedHandle"},"type":["array","null"]},"links":{"items":{"minLength":1,"type":"string"},"type":["array","null"]},"phones":{"items":{"minLength":1,"type":"string"},"type":["array","null"]}},"required":["emails","phones","links","handles"],"type":"object"},"TwitterExtractedHandle":{"additionalProperties":false,"properties":{"handle":{"minLength":1,"type":["string","null"]},"platform":{"minLength":1,"type":["string","null"]}},"required":["platform","handle"],"type":"object"},"TwitterFormatting":{"additionalProperties":false,"properties":{"range":{"$ref":"#/components/schemas/TwitterRange"},"types":{"items":{"minLength":1,"type":"string"},"type":["array","null"]}},"required":["range","types"],"type":"object"},"TwitterImage":{"additionalProperties":false,"properties":{"altText":{"minLength":1,"type":["string","null"]},"height":{"type":["integer","null"]},"isNft":{"type":["boolean","null"]},"role":{"minLength":1,"type":["string","null"]},"shape":{"minLength":1,"type":["string","null"]},"type":{"minLength":1,"type":["string","null"]},"url":{"format":"uri","minLength":1,"type":["string","null"]},"width":{"type":["integer","null"]}},"required":["type","url","role","width","height","altText","shape","isNft"],"type":"object"},"TwitterImageAltText":{"additionalProperties":false,"properties":{"role":{"minLength":1,"type":["string","null"]},"text":{"minLength":1,"type":["string","null"]}},"required":["role","text"],"type":"object"},"TwitterLabel":{"additionalProperties":false,"properties":{"description":{"anyOf":[{"$ref":"#/components/schemas/TwitterRichText"},{"type":"null"}]},"icon":{"anyOf":[{"$ref":"#/components/schemas/TwitterImage"},{"type":"null"}]},"text":{"minLength":1,"type":["string","null"]},"type":{"minLength":1,"type":["string","null"]},"url":{"format":"uri","minLength":1,"type":["string","null"]}},"required":["type","text","icon","url","description"],"type":"object"},"TwitterList":{"additionalProperties":false,"properties":{"banner":{"anyOf":[{"$ref":"#/components/schemas/TwitterImage"},{"type":"null"}]},"description":{"minLength":1,"type":["string","null"]},"id":{"minLength":1,"type":"string"},"metrics":{"$ref":"#/components/schemas/TwitterListMetrics"},"name":{"minLength":1,"type":["string","null"]},"owner":{"anyOf":[{"$ref":"#/components/schemas/TwitterProfileReference"},{"type":"null"}]}},"required":["id","name","description","owner","banner","metrics"],"type":"object"},"TwitterListMetrics":{"additionalProperties":false,"properties":{"members":{"type":["integer","null"]},"subscribers":{"type":["integer","null"]}},"required":["members","subscribers"],"type":"object"},"TwitterLongText":{"additionalProperties":false,"properties":{"formatting":{"items":{"$ref":"#/components/schemas/TwitterFormatting"},"type":["array","null"]},"id":{"minLength":1,"type":["string","null"]},"inlineMedia":{"items":{},"type":["array","null"]},"isExpandable":{"type":["boolean","null"]},"timestamps":{"items":{},"type":["array","null"]}},"required":["id","isExpandable","inlineMedia","formatting","timestamps"],"type":"object"},"TwitterMedia":{"additionalProperties":false,"properties":{"altText":{"minLength":1,"type":["string","null"]},"aspectRatio":{"anyOf":[{"$ref":"#/components/schemas/TwitterAspectRatio"},{"type":"null"}]},"availability":{"anyOf":[{"$ref":"#/components/schemas/TwitterMediaAvailability"},{"type":"null"}]},"duration":{"type":["number","null"]},"features":{"items":{"$ref":"#/components/schemas/TwitterMediaFeature"},"type":["array","null"]},"focusRegions":{"items":{"$ref":"#/components/schemas/TwitterRectangle"},"type":["array","null"]},"height":{"type":["integer","null"]},"id":{"minLength":1,"type":["string","null"]},"isAnimated":{"type":["boolean","null"]},"isMonetizable":{"type":["boolean","null"]},"key":{"minLength":1,"type":["string","null"]},"palette":{"items":{"$ref":"#/components/schemas/TwitterColor"},"type":["array","null"]},"restrictions":{"anyOf":[{"$ref":"#/components/schemas/TwitterMediaRestrictions"},{"type":"null"}]},"sizes":{"items":{"$ref":"#/components/schemas/TwitterMediaSize"},"type":["array","null"]},"source":{"anyOf":[{"$ref":"#/components/schemas/TwitterMediaSource"},{"type":"null"}]},"thumbnail":{"anyOf":[{"$ref":"#/components/schemas/TwitterImage"},{"type":"null"}]},"type":{"minLength":1,"type":["string","null"]},"url":{"format":"uri","minLength":1,"type":["string","null"]},"variants":{"items":{"$ref":"#/components/schemas/TwitterMediaVariant"},"type":["array","null"]},"width":{"type":["integer","null"]}},"required":["id","type","key","altText","isAnimated","source","width","height","focusRegions","features","sizes","duration","aspectRatio","variants","url","thumbnail","availability","restrictions","isMonetizable","palette"],"type":"object"},"TwitterMediaAvailability":{"additionalProperties":false,"properties":{"status":{"minLength":1,"type":["string","null"]}},"required":["status"],"type":"object"},"TwitterMediaFeature":{"additionalProperties":false,"properties":{"faceRegions":{"items":{"$ref":"#/components/schemas/TwitterRectangle"},"type":["array","null"]},"size":{"minLength":1,"type":["string","null"]},"taggedProfiles":{"items":{"$ref":"#/components/schemas/TwitterProfileReference"},"type":["array","null"]}},"required":["size","faceRegions","taggedProfiles"],"type":"object"},"TwitterMediaRestrictions":{"additionalProperties":false,"properties":{"isDmca":{"type":["boolean","null"]}},"required":["isDmca"],"type":"object"},"TwitterMediaSize":{"additionalProperties":false,"properties":{"height":{"type":["integer","null"]},"name":{"minLength":1,"type":["string","null"]},"resizeMode":{"minLength":1,"type":["string","null"]},"width":{"type":["integer","null"]}},"required":["name","width","height","resizeMode"],"type":"object"},"TwitterMediaSource":{"additionalProperties":false,"properties":{"authorId":{"minLength":1,"type":["string","null"]},"postId":{"minLength":1,"type":["string","null"]}},"required":["postId","authorId"],"type":"object"},"TwitterMediaVariant":{"additionalProperties":false,"properties":{"bitrate":{"type":["integer","null"]},"contentType":{"minLength":1,"type":["string","null"]},"url":{"format":"uri","minLength":1,"type":["string","null"]}},"required":["url","bitrate","contentType"],"type":"object"},"TwitterNotePresentation":{"additionalProperties":false,"properties":{"iconType":{"minLength":1,"type":["string","null"]},"style":{"minLength":1,"type":["string","null"]}},"required":["iconType","style"],"type":"object"},"TwitterPageMetadata":{"additionalProperties":false,"properties":{"cashtags":{"items":{},"type":["array","null"]},"context":{"anyOf":[{"$ref":"#/components/schemas/TwitterConversationContext"},{"type":"null"}]},"events":{"items":{},"type":["array","null"]},"hashtags":{"items":{},"type":["array","null"]},"lists":{"items":{},"type":["array","null"]},"metrics":{"additionalProperties":false,"properties":{"suggestions":{"type":["integer","null"]}},"required":["suggestions"],"type":"object"},"nextCursorLabel":{"minLength":1,"type":["string","null"]},"nextCursorType":{"minLength":1,"type":["string","null"]},"promoted":{"items":{"$ref":"#/components/schemas/TwitterPostReference"},"type":["array","null"]},"queries":{"items":{"$ref":"#/components/schemas/TwitterSuggestedQuery"},"type":["array","null"]},"query":{"minLength":1,"type":["string","null"]}},"required":["nextCursorType","nextCursorLabel","context","promoted","query","metrics","queries","cashtags","hashtags","events","lists"],"type":"object"},"TwitterPlace":{"additionalProperties":false,"properties":{"country":{"minLength":1,"type":["string","null"]},"countryCode":{"minLength":1,"type":["string","null"]},"fullName":{"minLength":1,"type":["string","null"]},"id":{"minLength":1,"type":["string","null"]},"name":{"minLength":1,"type":["string","null"]},"type":{"minLength":1,"type":["string","null"]}},"required":["id","name","fullName","type","country","countryCode"],"type":"object"},"TwitterPoll":{"additionalProperties":false,"properties":{"choices":{"items":{"$ref":"#/components/schemas/TwitterPollChoice"},"type":["array","null"]},"countsAreFinal":{"type":["boolean","null"]},"duration":{"type":["integer","null"]},"endsAt":{"format":"date-time","minLength":1,"type":["string","null"]},"metrics":{"additionalProperties":false,"properties":{"choices":{"type":"integer"}},"required":["choices"],"type":"object"},"updatedAt":{"format":"date-time","minLength":1,"type":["string","null"]}},"required":["metrics","choices","endsAt","updatedAt","countsAreFinal","duration"],"type":"object"},"TwitterPollChoice":{"additionalProperties":false,"properties":{"images":{"items":{"$ref":"#/components/schemas/TwitterImage"},"type":["array","null"]},"label":{"minLength":1,"type":["string","null"]},"metrics":{"additionalProperties":false,"properties":{"votes":{"type":"integer"}},"required":["votes"],"type":["object","null"]},"position":{"type":"integer"}},"required":["position","label","metrics","images"],"type":"object"},"TwitterPost":{"additionalProperties":false,"properties":{"article":{"anyOf":[{"$ref":"#/components/schemas/TwitterArticle"},{"type":"null"}]},"author":{"anyOf":[{"$ref":"#/components/schemas/TwitterProfileReference"},{"type":"null"}]},"authorId":{"minLength":1,"type":["string","null"]},"card":{"anyOf":[{"$ref":"#/components/schemas/TwitterCard"},{"type":"null"}]},"communityNote":{"anyOf":[{"$ref":"#/components/schemas/TwitterCommunityNote"},{"type":"null"}]},"conversationId":{"minLength":1,"type":["string","null"]},"createdAt":{"format":"date-time","minLength":1,"type":"string"},"displayTextRange":{"anyOf":[{"$ref":"#/components/schemas/TwitterRange"},{"type":"null"}]},"edit":{"anyOf":[{"$ref":"#/components/schemas/TwitterEdit"},{"type":"null"}]},"entities":{"items":{"$ref":"#/components/schemas/TwitterEntity"},"type":"array"},"extracted":{"$ref":"#/components/schemas/TwitterExtracted"},"hasGrokAnalysisButton":{"type":["boolean","null"]},"id":{"minLength":1,"type":"string"},"inReplyToHandle":{"minLength":1,"type":["string","null"]},"inReplyToPostId":{"minLength":1,"type":["string","null"]},"inReplyToUserId":{"minLength":1,"type":["string","null"]},"isPromoted":{"type":["boolean","null"]},"isQuote":{"type":["boolean","null"]},"isRepost":{"type":["boolean","null"]},"isSensitive":{"type":["boolean","null"]},"language":{"minLength":1,"type":["string","null"]},"longText":{"anyOf":[{"$ref":"#/components/schemas/TwitterLongText"},{"type":"null"}]},"media":{"items":{"$ref":"#/components/schemas/TwitterMedia"},"type":"array"},"metrics":{"$ref":"#/components/schemas/TwitterPostMetrics"},"preview":{"anyOf":[{"$ref":"#/components/schemas/TwitterPreview"},{"type":"null"}]},"previousMetrics":{"anyOf":[{"$ref":"#/components/schemas/TwitterPreviousMetrics"},{"type":"null"}]},"promotion":{"anyOf":[{"$ref":"#/components/schemas/TwitterPromotion"},{"type":"null"}]},"quotedPost":{"anyOf":[{"$ref":"#/components/schemas/TwitterPostReference"},{"type":"null"}]},"quotedPostId":{"minLength":1,"type":["string","null"]},"repostedPost":{"anyOf":[{"$ref":"#/components/schemas/TwitterPostReference"},{"type":"null"}]},"restrictions":{"items":{"$ref":"#/components/schemas/TwitterRestriction"},"type":["array","null"]},"text":{"minLength":1,"type":["string","null"]},"timeline":{"anyOf":[{"$ref":"#/components/schemas/TwitterTimelinePlacement"},{"type":"null"}]},"url":{"format":"uri","minLength":1,"type":"string"}},"required":["id","text","extracted","language","isSensitive","isQuote","createdAt","conversationId","authorId","inReplyToPostId","inReplyToUserId","inReplyToHandle","quotedPostId","author","url","metrics","displayTextRange","media","entities","edit","hasGrokAnalysisButton","communityNote","isRepost","repostedPost","quotedPost","preview","longText","article","previousMetrics","card","restrictions","isPromoted","promotion","timeline"],"type":"object"},"TwitterPostMetrics":{"additionalProperties":false,"properties":{"comments":{"type":["integer","null"]},"likes":{"type":["integer","null"]},"quotes":{"type":["integer","null"]},"reposts":{"type":["integer","null"]},"saves":{"type":["integer","null"]},"views":{"type":["integer","null"]},"viewsState":{"minLength":1,"type":["string","null"]}},"required":["likes","comments","reposts","quotes","saves","views","viewsState"],"type":"object"},"TwitterPostReference":{"additionalProperties":false,"properties":{"article":{"anyOf":[{"$ref":"#/components/schemas/TwitterArticle"},{"type":"null"}]},"author":{"anyOf":[{"$ref":"#/components/schemas/TwitterProfileReference"},{"type":"null"}]},"authorId":{"minLength":1,"type":["string","null"]},"card":{"anyOf":[{"$ref":"#/components/schemas/TwitterCard"},{"type":"null"}]},"communityNote":{"anyOf":[{"$ref":"#/components/schemas/TwitterCommunityNote"},{"type":"null"}]},"conversationId":{"minLength":1,"type":["string","null"]},"createdAt":{"format":"date-time","minLength":1,"type":["string","null"]},"displayTextRange":{"anyOf":[{"$ref":"#/components/schemas/TwitterRange"},{"type":"null"}]},"edit":{"anyOf":[{"$ref":"#/components/schemas/TwitterEdit"},{"type":"null"}]},"entities":{"items":{"$ref":"#/components/schemas/TwitterEntity"},"type":["array","null"]},"extracted":{"$ref":"#/components/schemas/TwitterExtracted"},"hasGrokAnalysisButton":{"type":["boolean","null"]},"id":{"minLength":1,"type":["string","null"]},"inReplyToHandle":{"minLength":1,"type":["string","null"]},"inReplyToPostId":{"minLength":1,"type":["string","null"]},"inReplyToUserId":{"minLength":1,"type":["string","null"]},"isPromoted":{"type":["boolean","null"]},"isQuote":{"type":["boolean","null"]},"isRepost":{"type":["boolean","null"]},"isSensitive":{"type":["boolean","null"]},"language":{"minLength":1,"type":["string","null"]},"longText":{"anyOf":[{"$ref":"#/components/schemas/TwitterLongText"},{"type":"null"}]},"media":{"items":{"$ref":"#/components/schemas/TwitterMedia"},"type":["array","null"]},"metrics":{"$ref":"#/components/schemas/TwitterPostMetrics"},"preview":{"anyOf":[{"$ref":"#/components/schemas/TwitterPreview"},{"type":"null"}]},"previousMetrics":{"anyOf":[{"$ref":"#/components/schemas/TwitterPreviousMetrics"},{"type":"null"}]},"promotion":{"anyOf":[{"$ref":"#/components/schemas/TwitterPromotion"},{"type":"null"}]},"quotedPost":{"anyOf":[{"$ref":"#/components/schemas/TwitterPostReference"},{"type":"null"}]},"quotedPostId":{"minLength":1,"type":["string","null"]},"repostedPost":{"anyOf":[{"$ref":"#/components/schemas/TwitterPostReference"},{"type":"null"}]},"restrictions":{"items":{"$ref":"#/components/schemas/TwitterRestriction"},"type":["array","null"]},"text":{"minLength":1,"type":["string","null"]},"timeline":{"anyOf":[{"$ref":"#/components/schemas/TwitterTimelinePlacement"},{"type":"null"}]},"url":{"format":"uri","minLength":1,"type":["string","null"]}},"required":["id","text","extracted","language","isSensitive","isQuote","createdAt","conversationId","authorId","inReplyToPostId","inReplyToUserId","inReplyToHandle","quotedPostId","author","url","metrics","displayTextRange","media","entities","edit","hasGrokAnalysisButton","communityNote","isRepost","repostedPost","quotedPost","preview","longText","article","previousMetrics","card","restrictions","isPromoted","promotion","timeline"],"type":"object"},"TwitterPreview":{"additionalProperties":false,"properties":{"displayTextRange":{"anyOf":[{"$ref":"#/components/schemas/TwitterRange"},{"type":"null"}]},"entities":{"items":{"$ref":"#/components/schemas/TwitterEntity"},"type":["array","null"]},"text":{"minLength":1,"type":["string","null"]}},"required":["text","entities","displayTextRange"],"type":"object"},"TwitterPreviousMetrics":{"additionalProperties":false,"properties":{"comments":{"type":["integer","null"]},"likes":{"type":["integer","null"]},"quotes":{"type":["integer","null"]}},"required":["likes","quotes","comments"],"type":"object"},"TwitterProfessional":{"additionalProperties":false,"properties":{"categories":{"items":{"$ref":"#/components/schemas/TwitterProfessionalCategory"},"type":["array","null"]},"type":{"minLength":1,"type":["string","null"]}},"required":["type","categories"],"type":"object"},"TwitterProfessionalCategory":{"additionalProperties":false,"properties":{"id":{"minLength":1,"type":["string","null"]},"name":{"minLength":1,"type":["string","null"]}},"required":["id","name"],"type":"object"},"TwitterProfile":{"additionalProperties":false,"properties":{"avatar":{"anyOf":[{"$ref":"#/components/schemas/TwitterImage"},{"type":"null"}]},"banner":{"anyOf":[{"$ref":"#/components/schemas/TwitterImage"},{"type":"null"}]},"bio":{"minLength":1,"type":["string","null"]},"createdAt":{"format":"date-time","minLength":1,"type":["string","null"]},"displayName":{"minLength":1,"type":["string","null"]},"entities":{"$ref":"#/components/schemas/TwitterProfileEntities"},"externalUrl":{"format":"uri","minLength":1,"type":["string","null"]},"extracted":{"$ref":"#/components/schemas/TwitterExtracted"},"handle":{"minLength":1,"type":"string"},"hasCustomTimelines":{"type":["boolean","null"]},"id":{"minLength":1,"type":"string"},"isLifelineInstitution":{"type":["boolean","null"]},"isPrivate":{"type":["boolean","null"]},"isSuspended":{"type":["boolean","null"]},"isVerified":{"type":["boolean","null"]},"labels":{"items":{"$ref":"#/components/schemas/TwitterLabel"},"type":["array","null"]},"location":{"anyOf":[{"$ref":"#/components/schemas/TwitterProfileLocation"},{"type":"null"}]},"metrics":{"$ref":"#/components/schemas/TwitterProfileMetrics"},"pinnedPostIds":{"items":{"minLength":1,"type":"string"},"type":["array","null"]},"professional":{"anyOf":[{"$ref":"#/components/schemas/TwitterProfessional"},{"type":"null"}]},"subscriptions":{"$ref":"#/components/schemas/TwitterSubscriptions"},"url":{"format":"uri","minLength":1,"type":"string"},"verification":{"$ref":"#/components/schemas/TwitterVerification"},"visibility":{"$ref":"#/components/schemas/TwitterVisibility"},"withheld":{"$ref":"#/components/schemas/TwitterWithheld"}},"required":["id","handle","displayName","bio","extracted","url","externalUrl","createdAt","location","avatar","banner","isPrivate","isSuspended","isVerified","hasCustomTimelines","isLifelineInstitution","metrics","verification","pinnedPostIds","entities","withheld","subscriptions","visibility","professional","labels"],"type":"object"},"TwitterProfileEntities":{"additionalProperties":false,"properties":{"bio":{"items":{"$ref":"#/components/schemas/TwitterEntity"},"type":["array","null"]},"externalUrl":{"items":{"$ref":"#/components/schemas/TwitterEntity"},"type":["array","null"]}},"required":["bio","externalUrl"],"type":"object"},"TwitterProfileLocation":{"additionalProperties":false,"properties":{"place":{"anyOf":[{"$ref":"#/components/schemas/TwitterPlace"},{"type":"null"}]},"text":{"minLength":1,"type":["string","null"]}},"required":["text","place"],"type":"object"},"TwitterProfileMetrics":{"additionalProperties":false,"properties":{"affiliates":{"type":["integer","null"]},"creatorSubscriptions":{"type":["integer","null"]},"followers":{"type":["integer","null"]},"following":{"type":["integer","null"]},"likedPosts":{"type":["integer","null"]},"mediaPosts":{"type":["integer","null"]},"posts":{"type":["integer","null"]}},"required":["followers","following","posts","likedPosts","mediaPosts","creatorSubscriptions","affiliates"],"type":"object"},"TwitterProfileReference":{"additionalProperties":false,"properties":{"avatar":{"anyOf":[{"$ref":"#/components/schemas/TwitterImage"},{"type":"null"}]},"banner":{"anyOf":[{"$ref":"#/components/schemas/TwitterImage"},{"type":"null"}]},"bio":{"minLength":1,"type":["string","null"]},"createdAt":{"format":"date-time","minLength":1,"type":["string","null"]},"displayName":{"minLength":1,"type":["string","null"]},"entities":{"$ref":"#/components/schemas/TwitterProfileEntities"},"externalUrl":{"format":"uri","minLength":1,"type":["string","null"]},"extracted":{"$ref":"#/components/schemas/TwitterExtracted"},"handle":{"minLength":1,"type":["string","null"]},"hasCustomTimelines":{"type":["boolean","null"]},"id":{"minLength":1,"type":["string","null"]},"isLifelineInstitution":{"type":["boolean","null"]},"isPrivate":{"type":["boolean","null"]},"isSuspended":{"type":["boolean","null"]},"isVerified":{"type":["boolean","null"]},"labels":{"items":{"$ref":"#/components/schemas/TwitterLabel"},"type":["array","null"]},"location":{"anyOf":[{"$ref":"#/components/schemas/TwitterProfileLocation"},{"type":"null"}]},"metrics":{"$ref":"#/components/schemas/TwitterProfileMetrics"},"pinnedPostIds":{"items":{"minLength":1,"type":"string"},"type":["array","null"]},"professional":{"anyOf":[{"$ref":"#/components/schemas/TwitterProfessional"},{"type":"null"}]},"subscriptions":{"$ref":"#/components/schemas/TwitterSubscriptions"},"url":{"format":"uri","minLength":1,"type":["string","null"]},"verification":{"$ref":"#/components/schemas/TwitterVerification"},"visibility":{"$ref":"#/components/schemas/TwitterVisibility"},"withheld":{"$ref":"#/components/schemas/TwitterWithheld"}},"required":["id","handle","displayName","bio","extracted","url","externalUrl","createdAt","location","avatar","banner","isPrivate","isSuspended","isVerified","hasCustomTimelines","isLifelineInstitution","metrics","verification","pinnedPostIds","entities","withheld","subscriptions","visibility","professional","labels"],"type":"object"},"TwitterPromotion":{"additionalProperties":false,"properties":{"advertiser":{"anyOf":[{"$ref":"#/components/schemas/TwitterProfileReference"},{"type":"null"}]}},"required":["advertiser"],"type":"object"},"TwitterRGB":{"additionalProperties":false,"properties":{"blue":{"type":"integer"},"green":{"type":"integer"},"red":{"type":"integer"}},"required":["red","green","blue"],"type":"object"},"TwitterRange":{"additionalProperties":false,"properties":{"end":{"type":"integer"},"start":{"type":"integer"}},"required":["start","end"],"type":"object"},"TwitterRectangle":{"additionalProperties":false,"properties":{"height":{"type":["integer","null"]},"width":{"type":["integer","null"]},"x":{"type":["integer","null"]},"y":{"type":["integer","null"]}},"required":["x","y","width","height"],"type":"object"},"TwitterRestriction":{"additionalProperties":false,"properties":{"action":{"minLength":1,"type":["string","null"]},"message":{"minLength":1,"type":["string","null"]}},"required":["action","message"],"type":"object"},"TwitterRichText":{"additionalProperties":false,"properties":{"entities":{"items":{"$ref":"#/components/schemas/TwitterEntity"},"type":["array","null"]},"text":{"minLength":1,"type":["string","null"]}},"required":["text","entities"],"type":"object"},"TwitterSubscriptions":{"additionalProperties":false,"properties":{"isEligible":{"type":["boolean","null"]}},"required":["isEligible"],"type":"object"},"TwitterSuggestedQuery":{"additionalProperties":false,"properties":{"text":{"minLength":1,"type":["string","null"]}},"required":["text"],"type":"object"},"TwitterTimelinePlacement":{"additionalProperties":false,"properties":{"conversationSection":{"minLength":1,"type":["string","null"]},"displayType":{"minLength":1,"type":["string","null"]},"moduleDisplayType":{"minLength":1,"type":["string","null"]},"position":{"type":["integer","null"]}},"required":["position","conversationSection","moduleDisplayType","displayType"],"type":"object"},"TwitterVerification":{"additionalProperties":false,"properties":{"isBlueVerified":{"type":["boolean","null"]},"legacyVerified":{"type":["boolean","null"]},"type":{"minLength":1,"type":["string","null"]}},"required":["legacyVerified","type","isBlueVerified"],"type":"object"},"TwitterVisibility":{"additionalProperties":false,"properties":{"hasHiddenLikesOnProfile":{"type":["boolean","null"]},"hasHiddenSubscriptionsOnProfile":{"type":["boolean","null"]}},"required":["hasHiddenLikesOnProfile","hasHiddenSubscriptionsOnProfile"],"type":"object"},"TwitterWithheld":{"additionalProperties":false,"properties":{"copyright":{"type":["boolean","null"]},"description":{"minLength":1,"type":["string","null"]},"scope":{"minLength":1,"type":["string","null"]}},"required":["copyright","description","scope"],"type":"object"},"YouTubeAudioTrack":{"additionalProperties":false,"properties":{"language":{"minLength":1,"type":["string","null"]},"name":{"minLength":1,"type":["string","null"]}},"required":["language","name"],"type":"object"},"YouTubeAuthor":{"additionalProperties":false,"properties":{"avatar":{"anyOf":[{"$ref":"#/components/schemas/YouTubeImage"},{"type":"null"}]},"displayName":{"minLength":1,"type":["string","null"]},"handle":{"minLength":1,"type":["string","null"]},"id":{"minLength":1,"type":["string","null"]},"isArtist":{"type":["boolean","null"]},"isVerified":{"type":["boolean","null"]}},"required":["id","handle","displayName","avatar","isVerified","isArtist"],"type":"object"},"YouTubeChartArtist":{"additionalProperties":false,"properties":{"id":{"minLength":1,"type":["string","null"]},"name":{"minLength":1,"type":["string","null"]}},"required":["id","name"],"type":"object"},"YouTubeChartEntry":{"additionalProperties":false,"properties":{"artists":{"items":{"$ref":"#/components/schemas/YouTubeChartArtist"},"type":["array","null"]},"channel":{"anyOf":[{"$ref":"#/components/schemas/YouTubeAuthor"},{"type":"null"}]},"duration":{"type":["integer","null"]},"id":{"minLength":1,"type":"string"},"label":{"minLength":1,"type":["string","null"]},"metrics":{"$ref":"#/components/schemas/YouTubeChartMetrics"},"postId":{"minLength":1,"type":["string","null"]},"rank":{"$ref":"#/components/schemas/YouTubeChartRank"},"releaseDate":{"minLength":1,"type":["string","null"]},"thumbnail":{"anyOf":[{"$ref":"#/components/schemas/YouTubeImage"},{"type":"null"}]},"title":{"minLength":1,"type":["string","null"]},"type":{"minLength":1,"type":["string","null"]},"url":{"format":"uri","minLength":1,"type":["string","null"]}},"required":["type","id","title","url","postId","duration","releaseDate","label","artists","channel","thumbnail","rank","metrics"],"type":"object"},"YouTubeChartMetrics":{"additionalProperties":false,"properties":{"views":{"type":["integer","null"]}},"required":["views"],"type":"object"},"YouTubeChartRank":{"additionalProperties":false,"properties":{"position":{"type":["integer","null"]},"previousPosition":{"type":["integer","null"]},"viewsChange":{"type":["number","null"]},"weeksOnChart":{"type":["integer","null"]}},"required":["position","previousPosition","weeksOnChart","viewsChange"],"type":"object"},"YouTubeChartWeek":{"additionalProperties":false,"properties":{"country":{"minLength":1,"type":["string","null"]},"endDate":{"minLength":1,"type":["string","null"]},"startDate":{"minLength":1,"type":["string","null"]}},"required":["country","startDate","endDate"],"type":"object"},"YouTubeComment":{"additionalProperties":false,"properties":{"approximateCreatedAt":{"format":"date-time","minLength":1,"type":["string","null"]},"author":{"anyOf":[{"$ref":"#/components/schemas/YouTubeAuthor"},{"type":"null"}]},"createdAt":{"format":"date-time","minLength":1,"type":["string","null"]},"createdAtLabel":{"minLength":1,"type":["string","null"]},"extracted":{"$ref":"#/components/schemas/YouTubeExtracted"},"id":{"minLength":1,"type":"string"},"isByPostAuthor":{"type":["boolean","null"]},"isEdited":{"type":["boolean","null"]},"metrics":{"$ref":"#/components/schemas/YouTubeCommentMetrics"},"parentId":{"minLength":1,"type":["string","null"]},"postId":{"minLength":1,"type":["string","null"]},"repliesToken":{"minLength":1,"type":["string","null"]},"text":{"minLength":1,"type":["string","null"]},"url":{"format":"uri","minLength":1,"type":"string"}},"required":["id","text","extracted","url","postId","parentId","author","isByPostAuthor","isEdited","createdAt","approximateCreatedAt","createdAtLabel","metrics","repliesToken"],"type":"object"},"YouTubeCommentMetrics":{"additionalProperties":false,"properties":{"isApproximate":{"type":["boolean","null"]},"likes":{"type":["integer","null"]},"replies":{"type":["integer","null"]}},"required":["likes","replies","isApproximate"],"type":"object"},"YouTubeCommunityPost":{"additionalProperties":false,"properties":{"approximateCreatedAt":{"format":"date-time","minLength":1,"type":["string","null"]},"author":{"anyOf":[{"$ref":"#/components/schemas/YouTubeAuthor"},{"type":"null"}]},"createdAt":{"format":"date-time","minLength":1,"type":["string","null"]},"createdAtLabel":{"minLength":1,"type":["string","null"]},"extracted":{"$ref":"#/components/schemas/YouTubeExtracted"},"id":{"minLength":1,"type":"string"},"images":{"items":{"$ref":"#/components/schemas/YouTubeImage"},"type":"array"},"metrics":{"$ref":"#/components/schemas/YouTubeCommunityPostMetrics"},"poll":{"anyOf":[{"$ref":"#/components/schemas/YouTubePoll"},{"type":"null"}]},"text":{"minLength":1,"type":["string","null"]},"url":{"format":"uri","minLength":1,"type":"string"}},"required":["id","text","extracted","url","author","createdAt","approximateCreatedAt","createdAtLabel","images","poll","metrics"],"type":"object"},"YouTubeCommunityPostMetrics":{"additionalProperties":false,"properties":{"comments":{"type":["integer","null"]},"isApproximate":{"type":["boolean","null"]},"likes":{"type":["integer","null"]}},"required":["likes","comments","isApproximate"],"type":"object"},"YouTubeExtracted":{"additionalProperties":false,"properties":{"emails":{"items":{"minLength":1,"type":"string"},"type":["array","null"]},"handles":{"items":{"$ref":"#/components/schemas/YouTubeExtractedHandle"},"type":["array","null"]},"links":{"items":{"minLength":1,"type":"string"},"type":["array","null"]},"phones":{"items":{"minLength":1,"type":"string"},"type":["array","null"]}},"required":["emails","phones","links","handles"],"type":"object"},"YouTubeExtractedHandle":{"additionalProperties":false,"properties":{"handle":{"minLength":1,"type":["string","null"]},"platform":{"minLength":1,"type":["string","null"]}},"required":["platform","handle"],"type":"object"},"YouTubeFileRendition":{"additionalProperties":false,"properties":{"audioLanguage":{"minLength":1,"type":["string","null"]},"audioQuality":{"minLength":1,"type":["string","null"]},"bitrate":{"type":["integer","null"]},"codecs":{"minLength":1,"type":["string","null"]},"fps":{"type":["integer","null"]},"hasAudio":{"type":"boolean"},"hasVideo":{"type":"boolean"},"height":{"type":["integer","null"]},"itag":{"type":"integer"},"mimeType":{"minLength":1,"type":["string","null"]},"quality":{"minLength":1,"type":["string","null"]},"size":{"type":["integer","null"]},"url":{"format":"uri","minLength":1,"type":["string","null"]},"width":{"type":["integer","null"]}},"required":["itag","quality","mimeType","codecs","width","height","fps","bitrate","size","audioQuality","audioLanguage","hasVideo","hasAudio","url"],"type":"object"},"YouTubeFiles":{"additionalProperties":false,"properties":{"author":{"anyOf":[{"$ref":"#/components/schemas/YouTubeAuthor"},{"type":"null"}]},"duration":{"type":["integer","null"]},"postId":{"minLength":1,"type":"string"},"renditions":{"items":{"$ref":"#/components/schemas/YouTubeFileRendition"},"type":"array"}},"required":["postId","author","duration","renditions"],"type":"object"},"YouTubeFrame":{"additionalProperties":false,"properties":{"at":{"type":"integer"},"postId":{"minLength":1,"type":"string"},"renditions":{"items":{"$ref":"#/components/schemas/YouTubeFrameRendition"},"type":"array"}},"required":["postId","at","renditions"],"type":"object"},"YouTubeFrameRendition":{"additionalProperties":false,"properties":{"height":{"type":["integer","null"]},"quality":{"minLength":1,"type":["string","null"]},"url":{"format":"uri","minLength":1,"type":["string","null"]}},"required":["quality","height","url"],"type":"object"},"YouTubeHashtag":{"additionalProperties":false,"properties":{"label":{"minLength":1,"type":["string","null"]},"name":{"minLength":1,"type":["string","null"]}},"required":["name","label"],"type":"object"},"YouTubeImage":{"additionalProperties":false,"properties":{"height":{"type":["integer","null"]},"renditions":{"items":{"$ref":"#/components/schemas/YouTubeImage"},"type":["array","null"]},"url":{"format":"uri","minLength":1,"type":["string","null"]},"width":{"type":["integer","null"]}},"required":["url","width","height","renditions"],"type":"object"},"YouTubeLink":{"additionalProperties":false,"properties":{"title":{"minLength":1,"type":["string","null"]},"url":{"format":"uri","minLength":1,"type":["string","null"]}},"required":["title","url"],"type":"object"},"YouTubeMusicCredit":{"additionalProperties":false,"properties":{"album":{"minLength":1,"type":["string","null"]},"artists":{"items":{"minLength":1,"type":"string"},"type":["array","null"]},"title":{"minLength":1,"type":["string","null"]}},"required":["title","artists","album"],"type":"object"},"YouTubePageMetadata":{"additionalProperties":false,"properties":{"category":{"minLength":1,"type":["string","null"]},"chartWeek":{"anyOf":[{"$ref":"#/components/schemas/YouTubeChartWeek"},{"type":"null"}]},"comments":{"type":["integer","null"]},"country":{"minLength":1,"type":["string","null"]},"estimatedResults":{"type":["integer","null"]},"hashtag":{"anyOf":[{"$ref":"#/components/schemas/YouTubeHashtag"},{"type":"null"}]},"playlist":{"anyOf":[{"$ref":"#/components/schemas/YouTubePlaylistReference"},{"type":"null"}]},"query":{"minLength":1,"type":["string","null"]}},"required":["query","estimatedResults","comments","playlist","hashtag","chartWeek","country","category"],"type":"object"},"YouTubePlaylist":{"additionalProperties":false,"properties":{"approximateUpdatedAt":{"format":"date-time","minLength":1,"type":["string","null"]},"author":{"anyOf":[{"$ref":"#/components/schemas/YouTubeAuthor"},{"type":"null"}]},"firstPostId":{"minLength":1,"type":["string","null"]},"id":{"minLength":1,"type":"string"},"metrics":{"$ref":"#/components/schemas/YouTubePlaylistMetrics"},"text":{"minLength":1,"type":["string","null"]},"thumbnail":{"anyOf":[{"$ref":"#/components/schemas/YouTubeImage"},{"type":"null"}]},"title":{"minLength":1,"type":["string","null"]},"type":{"minLength":1,"type":["string","null"]},"updatedAtLabel":{"minLength":1,"type":["string","null"]},"url":{"format":"uri","minLength":1,"type":"string"}},"required":["id","type","title","text","url","author","thumbnail","firstPostId","approximateUpdatedAt","updatedAtLabel","metrics"],"type":"object"},"YouTubePlaylistMetrics":{"additionalProperties":false,"properties":{"isApproximate":{"type":["boolean","null"]},"videos":{"type":["integer","null"]},"views":{"type":["integer","null"]}},"required":["videos","views","isApproximate"],"type":"object"},"YouTubePlaylistReference":{"additionalProperties":false,"properties":{"approximateUpdatedAt":{"format":"date-time","minLength":1,"type":["string","null"]},"author":{"anyOf":[{"$ref":"#/components/schemas/YouTubeAuthor"},{"type":"null"}]},"firstPostId":{"minLength":1,"type":["string","null"]},"id":{"minLength":1,"type":["string","null"]},"metrics":{"$ref":"#/components/schemas/YouTubePlaylistMetrics"},"text":{"minLength":1,"type":["string","null"]},"thumbnail":{"anyOf":[{"$ref":"#/components/schemas/YouTubeImage"},{"type":"null"}]},"title":{"minLength":1,"type":["string","null"]},"type":{"minLength":1,"type":["string","null"]},"updatedAtLabel":{"minLength":1,"type":["string","null"]},"url":{"format":"uri","minLength":1,"type":["string","null"]}},"required":["id","type","title","text","url","author","thumbnail","firstPostId","approximateUpdatedAt","updatedAtLabel","metrics"],"type":"object"},"YouTubePoll":{"additionalProperties":false,"properties":{"choices":{"items":{"minLength":1,"type":"string"},"type":["array","null"]},"votes":{"type":["integer","null"]}},"required":["choices","votes"],"type":"object"},"YouTubePost":{"additionalProperties":false,"properties":{"approximateCreatedAt":{"format":"date-time","minLength":1,"type":["string","null"]},"audioTracks":{"items":{"$ref":"#/components/schemas/YouTubeAudioTrack"},"type":["array","null"]},"author":{"anyOf":[{"$ref":"#/components/schemas/YouTubeAuthor"},{"type":"null"}]},"category":{"minLength":1,"type":["string","null"]},"createdAt":{"format":"date-time","minLength":1,"type":["string","null"]},"createdAtLabel":{"minLength":1,"type":["string","null"]},"duration":{"type":["integer","null"]},"extracted":{"$ref":"#/components/schemas/YouTubeExtracted"},"hasCaptions":{"type":["boolean","null"]},"hashtags":{"items":{"minLength":1,"type":"string"},"type":["array","null"]},"id":{"minLength":1,"type":"string"},"isEmbeddable":{"type":["boolean","null"]},"isFamilySafe":{"type":["boolean","null"]},"isLiveNow":{"type":["boolean","null"]},"isLiveStream":{"type":["boolean","null"]},"isUnlisted":{"type":["boolean","null"]},"keywords":{"items":{"minLength":1,"type":"string"},"type":["array","null"]},"language":{"minLength":1,"type":["string","null"]},"liveStartedAt":{"format":"date-time","minLength":1,"type":["string","null"]},"metrics":{"$ref":"#/components/schemas/YouTubePostMetrics"},"music":{"items":{"$ref":"#/components/schemas/YouTubeMusicCredit"},"type":["array","null"]},"preview":{"anyOf":[{"$ref":"#/components/schemas/YouTubeImage"},{"type":"null"}]},"subtitles":{"items":{"$ref":"#/components/schemas/YouTubeSubtitle"},"type":["array","null"]},"text":{"minLength":1,"type":["string","null"]},"thumbnail":{"anyOf":[{"$ref":"#/components/schemas/YouTubeImage"},{"type":"null"}]},"title":{"minLength":1,"type":["string","null"]},"type":{"minLength":1,"type":["string","null"]},"url":{"format":"uri","minLength":1,"type":"string"}},"required":["id","type","title","text","extracted","url","createdAt","approximateCreatedAt","createdAtLabel","duration","category","language","hashtags","keywords","author","thumbnail","preview","isFamilySafe","isUnlisted","isEmbeddable","isLiveStream","isLiveNow","liveStartedAt","hasCaptions","subtitles","audioTracks","music","metrics"],"type":"object"},"YouTubePostMetrics":{"additionalProperties":false,"properties":{"comments":{"type":["integer","null"]},"isApproximate":{"type":["boolean","null"]},"likes":{"type":["integer","null"]},"views":{"type":["integer","null"]},"watching":{"type":["integer","null"]}},"required":["views","likes","comments","watching","isApproximate"],"type":"object"},"YouTubeProduct":{"additionalProperties":false,"properties":{"image":{"anyOf":[{"$ref":"#/components/schemas/YouTubeImage"},{"type":"null"}]},"merchant":{"minLength":1,"type":["string","null"]},"price":{"minLength":1,"type":["string","null"]},"priceLabel":{"minLength":1,"type":["string","null"]},"shelf":{"minLength":1,"type":["string","null"]},"title":{"minLength":1,"type":["string","null"]},"url":{"format":"uri","minLength":1,"type":"string"}},"required":["title","url","merchant","price","priceLabel","shelf","image"],"type":"object"},"YouTubeProfile":{"additionalProperties":false,"properties":{"avatar":{"anyOf":[{"$ref":"#/components/schemas/YouTubeImage"},{"type":"null"}]},"banner":{"anyOf":[{"$ref":"#/components/schemas/YouTubeImage"},{"type":"null"}]},"bio":{"minLength":1,"type":["string","null"]},"country":{"minLength":1,"type":["string","null"]},"displayName":{"minLength":1,"type":["string","null"]},"extracted":{"$ref":"#/components/schemas/YouTubeExtracted"},"handle":{"minLength":1,"type":"string"},"hasBusinessEmail":{"type":["boolean","null"]},"id":{"minLength":1,"type":"string"},"isFamilySafe":{"type":["boolean","null"]},"joinedAt":{"format":"date-time","minLength":1,"type":["string","null"]},"keywords":{"items":{"minLength":1,"type":"string"},"type":["array","null"]},"links":{"items":{"$ref":"#/components/schemas/YouTubeLink"},"type":["array","null"]},"metrics":{"$ref":"#/components/schemas/YouTubeProfileMetrics"},"url":{"format":"uri","minLength":1,"type":"string"}},"required":["id","handle","displayName","bio","extracted","url","country","joinedAt","keywords","links","avatar","banner","isFamilySafe","hasBusinessEmail","metrics"],"type":"object"},"YouTubeProfileMetrics":{"additionalProperties":false,"properties":{"isApproximate":{"type":["boolean","null"]},"subscribers":{"type":["integer","null"]},"videos":{"type":["integer","null"]},"views":{"type":["integer","null"]}},"required":["subscribers","videos","views","isApproximate"],"type":"object"},"YouTubeSegment":{"additionalProperties":false,"properties":{"end":{"type":"integer"},"start":{"type":"integer"},"text":{"minLength":1,"type":["string","null"]}},"required":["start","end","text"],"type":"object"},"YouTubeStoryboard":{"additionalProperties":false,"properties":{"author":{"anyOf":[{"$ref":"#/components/schemas/YouTubeAuthor"},{"type":"null"}]},"columns":{"type":"integer"},"frameCount":{"type":"integer"},"frameHeight":{"type":"integer"},"frameWidth":{"type":"integer"},"frames":{"items":{"$ref":"#/components/schemas/YouTubeStoryboardFrame"},"type":"array"},"intervalMs":{"type":"integer"},"postId":{"minLength":1,"type":"string"},"rows":{"type":"integer"},"sheets":{"items":{"$ref":"#/components/schemas/YouTubeStoryboardSheet"},"type":"array"}},"required":["postId","author","intervalMs","frameWidth","frameHeight","columns","rows","frameCount","sheets","frames"],"type":"object"},"YouTubeStoryboardFrame":{"additionalProperties":false,"properties":{"sheet":{"type":"integer"},"timeMs":{"type":"integer"},"x":{"type":"integer"},"y":{"type":"integer"}},"required":["timeMs","sheet","x","y"],"type":"object"},"YouTubeStoryboardSheet":{"additionalProperties":false,"properties":{"frameCount":{"type":"integer"},"height":{"type":"integer"},"index":{"type":"integer"},"startMs":{"type":"integer"},"url":{"format":"uri","minLength":1,"type":["string","null"]},"width":{"type":"integer"}},"required":["index","url","width","height","startMs","frameCount"],"type":"object"},"YouTubeSubtitle":{"additionalProperties":false,"properties":{"isAutoGenerated":{"type":["boolean","null"]},"isTranslatable":{"type":["boolean","null"]},"language":{"minLength":1,"type":["string","null"]},"name":{"minLength":1,"type":["string","null"]}},"required":["language","name","isAutoGenerated","isTranslatable"],"type":"object"},"YouTubeSuggestion":{"additionalProperties":false,"properties":{"text":{"minLength":1,"type":"string"}},"required":["text"],"type":"object"},"YouTubeTranscript":{"additionalProperties":false,"properties":{"isAutoGenerated":{"type":["boolean","null"]},"language":{"minLength":1,"type":["string","null"]},"languageName":{"minLength":1,"type":["string","null"]},"languages":{"items":{"$ref":"#/components/schemas/YouTubeSubtitle"},"type":"array"},"postId":{"minLength":1,"type":"string"},"segments":{"items":{"$ref":"#/components/schemas/YouTubeSegment"},"type":"array"}},"required":["postId","language","languageName","isAutoGenerated","segments","languages"],"type":"object"}},"securitySchemes":{"OpenhandleKey":{"description":"Use an oh_test_ key for synthetic data and $0.000 actual charges, or an oh_live_ key for real public data and normal billing. Legacy oh_ keys remain Live.","scheme":"bearer","type":"http"},"OpenhandleMCPOAuth":{"description":"OAuth grants for the MCP endpoint only. REST operations require OpenhandleKey.","flows":{"authorizationCode":{"authorizationUrl":"https://api.openhandle.dev/oauth/authorize","scopes":{"mcp":"Read public social data through all MCP platform tools.","read:account":"Read workspace balance, usage, request history, and API key details through MCP tools.","read:instagram":"Read public Instagram data through MCP tools.","read:reddit":"Read public Reddit data through MCP tools.","read:tiktok":"Read public TikTok data through MCP tools.","read:twitter":"Read public X (Twitter) data through MCP tools.","read:youtube":"Read public YouTube data through MCP tools."},"tokenUrl":"https://api.openhandle.dev/oauth/token"}},"type":"oauth2"}}},"externalDocs":{"description":"Test environment guide","url":"https://openhandle.dev/docs/test-environment"},"info":{"description":"Read public social data through one API contract. API keys starting with oh_test_ use the deterministic synthetic dataset and record a $0.000 actual charge. Keys starting with oh_live_, plus legacy oh_ keys, use real public data and normal billing. Do not send an environment parameter or header.","title":"Openhandle API","version":"1.2.10"},"openapi":"3.1.0","paths":{"/v1/instagram/comments/{identifier}/likers":{"get":{"description":"List comment likers from public Instagram data. Test and Live use the same route, parameters, response schema, pagination, and errors. In Test, null means unavailable, not zero.","operationId":"Instagram_comment_likers_list","parameters":[{"description":"Public resource reference. Profile paths accept a username with an @ prefix, such as @openai, or the stable platform ID. Post paths accept the platform post ID or shortcode.","example":"910100000001","in":"path","name":"identifier","required":true,"schema":{"minLength":1,"type":"string"}},{"description":"Opaque native media ID associated with the selected resource.","example":"910100000001","in":"query","name":"media_id","required":true,"schema":{"minLength":1,"type":"string"}},{"description":"Maximum accepted data age. The default is 24h.","example":"24h","in":"query","name":"freshness","required":false,"schema":{"default":"24h","enum":["live","24h","7d","30d"],"type":"string"}},{"description":"Opaque cursor returned by the previous page.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/SuccessEnvelope"},{"properties":{"data":{"items":{"$ref":"#/components/schemas/InstagramProfileSummary"},"type":"array"}},"required":["data","meta"],"type":"object"}]}}},"description":"A successful Test or Live response.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The locator, cursor, or query is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The API key is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Live billing does not permit this request.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource is private or workspace API access is security-suspended.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource does not exist.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer accepts this cursor. Restart pagination from the first page.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer serves this data. Retrying fails the same way.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request rate limit was exceeded.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"451":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The owner of this profile asked Openhandle not to serve it.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request failed internally.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The service is temporarily unavailable.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}}},"security":[{"OpenhandleKey":[]}],"summary":"List comment likers","tags":["Instagram","Entity"],"x-openhandle-operation":"instagram.comment.likers.list","x-openhandle-sdk":{"operation":"list","paginated":true,"path":"instagram.comment.likers.list","scope":[{"name":"instagram"},{"name":"comment","parameter":"identifier","reference":"comment"},{"name":"likers"}]},"x-openhandle-test-data":{"catalogUrl":"/v1/test-data?operation=instagram.comment.likers.list","contentHash":"sha256:7794275e0d6f248bb315a82bf631385a86ae70d2957dd815951fce7615602735","datasetVersion":"2026-10-27.2","example":{"comment":"synthetic comment","identifier":"910100000001","media_id":"910100000001","query":"synthetic"}}}},"/v1/instagram/hashtags/{identifier}":{"get":{"description":"Return one public hashtag by its native identifier. Test and Live use the same route, parameters, response schema, pagination, and errors. In Test, null means unavailable, not zero.","operationId":"instagramHashtagGet","parameters":[{"description":"Public resource reference. Profile paths accept a username with an @ prefix, such as @openai, or the stable platform ID. Post paths accept the platform post ID or shortcode.","example":"syntheticvolume","in":"path","name":"identifier","required":true,"schema":{"minLength":1,"type":"string"}},{"description":"Maximum accepted data age. The default is 24h.","example":"24h","in":"query","name":"freshness","required":false,"schema":{"default":"24h","enum":["live","24h","7d","30d"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/SuccessEnvelope"},{"properties":{"data":{"$ref":"#/components/schemas/InstagramHashtag"}},"required":["data"],"type":"object"}]}}},"description":"A successful Test or Live response.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The locator, cursor, or query is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The API key is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Live billing does not permit this request.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource is private or workspace API access is security-suspended.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource does not exist.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer serves this data. Retrying fails the same way.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request rate limit was exceeded.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"451":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The owner of this profile asked Openhandle not to serve it.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request failed internally.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The service is temporarily unavailable.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}}},"security":[{"OpenhandleKey":[]}],"summary":"Get a hashtag","tags":["Instagram","Hashtag"],"x-openhandle-operation":"instagram.hashtag.get","x-openhandle-sdk":{"operation":"get","paginated":false,"path":"instagram.hashtag.get","scope":[{"name":"instagram"},{"name":"hashtag","parameter":"identifier","reference":"hashtag"}]},"x-openhandle-test-data":{"catalogUrl":"/v1/test-data?operation=instagram.hashtag.get","contentHash":"sha256:7794275e0d6f248bb315a82bf631385a86ae70d2957dd815951fce7615602735","datasetVersion":"2026-10-27.2","example":{"identifier":"syntheticvolume","query":"synthetic"}}}},"/v1/instagram/hashtags/{identifier}/posts":{"get":{"description":"Return a cursor-paginated collection of public posts. Test and Live use the same route, parameters, response schema, pagination, and errors. In Test, null means unavailable, not zero.","operationId":"instagramHashtagPostsList","parameters":[{"description":"Public resource reference. Profile paths accept a username with an @ prefix, such as @openai, or the stable platform ID. Post paths accept the platform post ID or shortcode.","example":"syntheticvolume","in":"path","name":"identifier","required":true,"schema":{"minLength":1,"type":"string"}},{"description":"Result ordering for this operation.","example":"recent","in":"query","name":"sort","required":false,"schema":{"default":"recent","enum":["recent","top"],"type":"string"}},{"description":"Maximum accepted data age. The default is 24h.","example":"24h","in":"query","name":"freshness","required":false,"schema":{"default":"24h","enum":["live","24h","7d","30d"],"type":"string"}},{"description":"Opaque cursor returned by the previous page.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/SuccessEnvelope"},{"properties":{"data":{"items":{"$ref":"#/components/schemas/InstagramPost"},"type":"array"}},"required":["data","meta"],"type":"object"}]}}},"description":"A successful Test or Live response.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The locator, cursor, or query is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The API key is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Live billing does not permit this request.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource is private or workspace API access is security-suspended.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource does not exist.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer accepts this cursor. Restart pagination from the first page.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer serves this data. Retrying fails the same way.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request rate limit was exceeded.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"451":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The owner of this profile asked Openhandle not to serve it.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request failed internally.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The service is temporarily unavailable.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}}},"security":[{"OpenhandleKey":[]}],"summary":"List hashtag posts","tags":["Instagram","Post"],"x-openhandle-operation":"instagram.hashtag.posts.list","x-openhandle-sdk":{"operation":"list","paginated":true,"path":"instagram.hashtag.posts.list","scope":[{"name":"instagram"},{"name":"hashtag","parameter":"identifier","reference":"hashtag"},{"name":"posts"}]},"x-openhandle-test-data":{"catalogUrl":"/v1/test-data?operation=instagram.hashtag.posts.list","contentHash":"sha256:7794275e0d6f248bb315a82bf631385a86ae70d2957dd815951fce7615602735","datasetVersion":"2026-10-27.2","example":{"identifier":"syntheticvolume","query":"synthetic"}}}},"/v1/instagram/hashtags/{identifier}/reels":{"get":{"description":"Return a cursor-paginated collection of Instagram reels for a hashtag. Test and Live use the same route, parameters, response schema, pagination, and errors. In Test, null means unavailable, not zero.","operationId":"instagramHashtagReelsList","parameters":[{"description":"Public resource reference. Profile paths accept a username with an @ prefix, such as @openai, or the stable platform ID. Post paths accept the platform post ID or shortcode.","example":"910100000001","in":"path","name":"identifier","required":true,"schema":{"minLength":1,"type":"string"}},{"description":"Maximum accepted data age. The default is 24h.","example":"24h","in":"query","name":"freshness","required":false,"schema":{"default":"24h","enum":["live","24h","7d","30d"],"type":"string"}},{"description":"Opaque cursor returned by the previous page.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/SuccessEnvelope"},{"properties":{"data":{"items":{"$ref":"#/components/schemas/InstagramPost"},"type":"array"}},"required":["data","meta"],"type":"object"}]}}},"description":"A successful Test or Live response.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The locator, cursor, or query is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The API key is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Live billing does not permit this request.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource is private or workspace API access is security-suspended.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource does not exist.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer accepts this cursor. Restart pagination from the first page.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer serves this data. Retrying fails the same way.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request rate limit was exceeded.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"451":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The owner of this profile asked Openhandle not to serve it.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request failed internally.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The service is temporarily unavailable.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}}},"security":[{"OpenhandleKey":[]}],"summary":"List hashtag reels","tags":["Instagram","Post"],"x-openhandle-operation":"instagram.hashtag.reels.list","x-openhandle-sdk":{"operation":"list","paginated":true,"path":"instagram.hashtag.reels.list","scope":[{"name":"instagram"},{"name":"hashtag","parameter":"identifier","reference":"hashtag"},{"name":"reels"}]},"x-openhandle-test-data":{"catalogUrl":"/v1/test-data?operation=instagram.hashtag.reels.list","contentHash":"sha256:7794275e0d6f248bb315a82bf631385a86ae70d2957dd815951fce7615602735","datasetVersion":"2026-10-27.2","example":{"identifier":"910100000001"}}}},"/v1/instagram/highlights/{identifier}":{"get":{"description":"Get a highlight from public Instagram data. Test and Live use the same route, parameters, response schema, pagination, and errors. In Test, null means unavailable, not zero.","operationId":"Instagram_highlight_get","parameters":[{"description":"Public resource reference. Profile paths accept a username with an @ prefix, such as @openai, or the stable platform ID. Post paths accept the platform post ID or shortcode.","example":"910100000001","in":"path","name":"identifier","required":true,"schema":{"minLength":1,"type":"string"}},{"description":"Maximum accepted data age. The default is 24h.","example":"24h","in":"query","name":"freshness","required":false,"schema":{"default":"24h","enum":["live","24h","7d","30d"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/SuccessEnvelope"},{"properties":{"data":{"$ref":"#/components/schemas/InstagramHighlight"}},"required":["data"],"type":"object"}]}}},"description":"A successful Test or Live response.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The locator, cursor, or query is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The API key is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Live billing does not permit this request.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource is private or workspace API access is security-suspended.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource does not exist.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer serves this data. Retrying fails the same way.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request rate limit was exceeded.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"451":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The owner of this profile asked Openhandle not to serve it.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request failed internally.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The service is temporarily unavailable.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}}},"security":[{"OpenhandleKey":[]}],"summary":"Get a highlight","tags":["Instagram","Entity"],"x-openhandle-operation":"instagram.highlight.get","x-openhandle-sdk":{"operation":"get","paginated":false,"path":"instagram.highlight.get","scope":[{"name":"instagram"},{"name":"highlight","parameter":"identifier","reference":"highlight"}]},"x-openhandle-test-data":{"catalogUrl":"/v1/test-data?operation=instagram.highlight.get","contentHash":"sha256:7794275e0d6f248bb315a82bf631385a86ae70d2957dd815951fce7615602735","datasetVersion":"2026-10-27.2","example":{"comment":"synthetic comment","identifier":"910100000001","media_id":"910100000001","query":"synthetic"}}}},"/v1/instagram/locations/{identifier}":{"get":{"description":"Return one public location by its native identifier. Test and Live use the same route, parameters, response schema, pagination, and errors. In Test, null means unavailable, not zero.","operationId":"instagramLocationGet","parameters":[{"description":"Public resource reference. Profile paths accept a username with an @ prefix, such as @openai, or the stable platform ID. Post paths accept the platform post ID or shortcode.","example":"950000000002","in":"path","name":"identifier","required":true,"schema":{"minLength":1,"type":"string"}},{"description":"Maximum accepted data age. The default is 24h.","example":"24h","in":"query","name":"freshness","required":false,"schema":{"default":"24h","enum":["live","24h","7d","30d"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/SuccessEnvelope"},{"properties":{"data":{"$ref":"#/components/schemas/InstagramLocation"}},"required":["data"],"type":"object"}]}}},"description":"A successful Test or Live response.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The locator, cursor, or query is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The API key is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Live billing does not permit this request.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource is private or workspace API access is security-suspended.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource does not exist.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer serves this data. Retrying fails the same way.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request rate limit was exceeded.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"451":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The owner of this profile asked Openhandle not to serve it.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request failed internally.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The service is temporarily unavailable.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}}},"security":[{"OpenhandleKey":[]}],"summary":"Get a location","tags":["Instagram","Location"],"x-openhandle-operation":"instagram.location.get","x-openhandle-sdk":{"operation":"get","paginated":false,"path":"instagram.location.get","scope":[{"name":"instagram"},{"name":"location","parameter":"identifier","reference":"location"}]},"x-openhandle-test-data":{"catalogUrl":"/v1/test-data?operation=instagram.location.get","contentHash":"sha256:7794275e0d6f248bb315a82bf631385a86ae70d2957dd815951fce7615602735","datasetVersion":"2026-10-27.2","example":{"identifier":"950000000002","query":"synthetic"}}}},"/v1/instagram/locations/{identifier}/posts":{"get":{"description":"Return a cursor-paginated collection of public posts. Test and Live use the same route, parameters, response schema, pagination, and errors. In Test, null means unavailable, not zero.","operationId":"instagramLocationPostsList","parameters":[{"description":"Public resource reference. Profile paths accept a username with an @ prefix, such as @openai, or the stable platform ID. Post paths accept the platform post ID or shortcode.","example":"950000000002","in":"path","name":"identifier","required":true,"schema":{"minLength":1,"type":"string"}},{"description":"Result ordering for this operation.","example":"recent","in":"query","name":"sort","required":false,"schema":{"default":"recent","enum":["recent","top"],"type":"string"}},{"description":"Maximum accepted data age. The default is 24h.","example":"24h","in":"query","name":"freshness","required":false,"schema":{"default":"24h","enum":["live","24h","7d","30d"],"type":"string"}},{"description":"Opaque cursor returned by the previous page.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/SuccessEnvelope"},{"properties":{"data":{"items":{"$ref":"#/components/schemas/InstagramPost"},"type":"array"}},"required":["data","meta"],"type":"object"}]}}},"description":"A successful Test or Live response.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The locator, cursor, or query is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The API key is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Live billing does not permit this request.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource is private or workspace API access is security-suspended.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource does not exist.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer accepts this cursor. Restart pagination from the first page.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer serves this data. Retrying fails the same way.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request rate limit was exceeded.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"451":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The owner of this profile asked Openhandle not to serve it.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request failed internally.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The service is temporarily unavailable.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}}},"security":[{"OpenhandleKey":[]}],"summary":"List location posts","tags":["Instagram","Post"],"x-openhandle-operation":"instagram.location.posts.list","x-openhandle-sdk":{"operation":"list","paginated":true,"path":"instagram.location.posts.list","scope":[{"name":"instagram"},{"name":"location","parameter":"identifier","reference":"location"},{"name":"posts"}]},"x-openhandle-test-data":{"catalogUrl":"/v1/test-data?operation=instagram.location.posts.list","contentHash":"sha256:7794275e0d6f248bb315a82bf631385a86ae70d2957dd815951fce7615602735","datasetVersion":"2026-10-27.2","example":{"identifier":"950000000002","query":"synthetic"}}}},"/v1/instagram/music/{identifier}":{"get":{"description":"Return one public music by its native identifier. Test and Live use the same route, parameters, response schema, pagination, and errors. In Test, null means unavailable, not zero.","operationId":"instagramMusicGet","parameters":[{"description":"Public resource reference. Profile paths accept a username with an @ prefix, such as @openai, or the stable platform ID. Post paths accept the platform post ID or shortcode.","example":"950000000003","in":"path","name":"identifier","required":true,"schema":{"minLength":1,"type":"string"}},{"description":"Maximum accepted data age. The default is 24h.","example":"24h","in":"query","name":"freshness","required":false,"schema":{"default":"24h","enum":["live","24h","7d","30d"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/SuccessEnvelope"},{"properties":{"data":{"$ref":"#/components/schemas/InstagramMusic"}},"required":["data"],"type":"object"}]}}},"description":"A successful Test or Live response.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The locator, cursor, or query is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The API key is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Live billing does not permit this request.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource is private or workspace API access is security-suspended.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource does not exist.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer serves this data. Retrying fails the same way.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request rate limit was exceeded.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"451":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The owner of this profile asked Openhandle not to serve it.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request failed internally.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The service is temporarily unavailable.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}}},"security":[{"OpenhandleKey":[]}],"summary":"Get a music","tags":["Instagram","Music"],"x-openhandle-operation":"instagram.music.get","x-openhandle-sdk":{"operation":"get","paginated":false,"path":"instagram.music.get","scope":[{"name":"instagram"},{"name":"music","parameter":"identifier","reference":"music"}]},"x-openhandle-test-data":{"catalogUrl":"/v1/test-data?operation=instagram.music.get","contentHash":"sha256:7794275e0d6f248bb315a82bf631385a86ae70d2957dd815951fce7615602735","datasetVersion":"2026-10-27.2","example":{"identifier":"950000000003","query":"synthetic"}}}},"/v1/instagram/music/{identifier}/stream":{"get":{"description":"List music stream pages from public Instagram data. Test and Live use the same route, parameters, response schema, pagination, and errors. In Test, null means unavailable, not zero.","operationId":"Instagram_music_stream_list","parameters":[{"description":"Public resource reference. Profile paths accept a username with an @ prefix, such as @openai, or the stable platform ID. Post paths accept the platform post ID or shortcode.","example":"910100000001","in":"path","name":"identifier","required":true,"schema":{"minLength":1,"type":"string"}},{"description":"Maximum accepted data age. The default is 24h.","example":"24h","in":"query","name":"freshness","required":false,"schema":{"default":"24h","enum":["live","24h","7d","30d"],"type":"string"}},{"description":"Opaque cursor returned by the previous page.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/SuccessEnvelope"},{"properties":{"data":{"items":{"$ref":"#/components/schemas/InstagramMusicStream"},"type":"array"}},"required":["data","meta"],"type":"object"}]}}},"description":"A successful Test or Live response.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The locator, cursor, or query is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The API key is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Live billing does not permit this request.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource is private or workspace API access is security-suspended.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource does not exist.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer accepts this cursor. Restart pagination from the first page.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer serves this data. Retrying fails the same way.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request rate limit was exceeded.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"451":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The owner of this profile asked Openhandle not to serve it.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request failed internally.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The service is temporarily unavailable.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}}},"security":[{"OpenhandleKey":[]}],"summary":"List music stream pages","tags":["Instagram","Entity"],"x-openhandle-operation":"instagram.music.stream.list","x-openhandle-sdk":{"operation":"list","paginated":true,"path":"instagram.music.stream.list","scope":[{"name":"instagram"},{"name":"music","parameter":"identifier","reference":"music"},{"name":"stream"}]},"x-openhandle-test-data":{"catalogUrl":"/v1/test-data?operation=instagram.music.stream.list","contentHash":"sha256:7794275e0d6f248bb315a82bf631385a86ae70d2957dd815951fce7615602735","datasetVersion":"2026-10-27.2","example":{"comment":"synthetic comment","identifier":"910100000001","media_id":"910100000001","query":"synthetic"}}}},"/v1/instagram/posts/{identifier}":{"get":{"description":"Get a post by a canonical platform identifier. URLs must be converted before calling a data endpoint. Test and Live use the same route, parameters, response schema, pagination, and errors. In Test, null means unavailable, not zero.","operationId":"instagramPostGet","parameters":[{"description":"Public resource reference. Profile paths accept a username with an @ prefix, such as @openai, or the stable platform ID. Post paths accept the platform post ID or shortcode.","example":"910100000001","in":"path","name":"identifier","required":true,"schema":{"minLength":1,"type":"string"}},{"description":"Maximum accepted data age. The default is 24h.","example":"24h","in":"query","name":"freshness","required":false,"schema":{"default":"24h","enum":["live","24h","7d","30d"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/SuccessEnvelope"},{"properties":{"data":{"$ref":"#/components/schemas/InstagramPost"}},"required":["data"],"type":"object"}]}}},"description":"A successful Test or Live response.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The locator, cursor, or query is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The API key is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Live billing does not permit this request.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource is private or workspace API access is security-suspended.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource does not exist.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer serves this data. Retrying fails the same way.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request rate limit was exceeded.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"451":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The owner of this profile asked Openhandle not to serve it.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request failed internally.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The service is temporarily unavailable.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}}},"security":[{"OpenhandleKey":[]}],"summary":"Get a post","tags":["Instagram","Post"],"x-openhandle-operation":"instagram.post.get","x-openhandle-sdk":{"operation":"get","paginated":false,"path":"instagram.post.get","scope":[{"name":"instagram"},{"name":"post","parameter":"identifier","reference":"post"}]},"x-openhandle-test-data":{"catalogUrl":"/v1/test-data?operation=instagram.post.get","contentHash":"sha256:7794275e0d6f248bb315a82bf631385a86ae70d2957dd815951fce7615602735","datasetVersion":"2026-10-27.2","example":{"identifier":"910100000001"}}}},"/v1/instagram/posts/{identifier}/clip-metadata":{"get":{"description":"Get clip metadata from public Instagram data. Test and Live use the same route, parameters, response schema, pagination, and errors. In Test, null means unavailable, not zero.","operationId":"Instagram_post_clip_metadata_get","parameters":[{"description":"Public resource reference. Profile paths accept a username with an @ prefix, such as @openai, or the stable platform ID. Post paths accept the platform post ID or shortcode.","example":"910100000001","in":"path","name":"identifier","required":true,"schema":{"minLength":1,"type":"string"}},{"description":"Maximum accepted data age. The default is 24h.","example":"24h","in":"query","name":"freshness","required":false,"schema":{"default":"24h","enum":["live","24h","7d","30d"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/SuccessEnvelope"},{"properties":{"data":{"$ref":"#/components/schemas/InstagramClipMetadata"}},"required":["data"],"type":"object"}]}}},"description":"A successful Test or Live response.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The locator, cursor, or query is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The API key is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Live billing does not permit this request.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource is private or workspace API access is security-suspended.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource does not exist.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer serves this data. Retrying fails the same way.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request rate limit was exceeded.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"451":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The owner of this profile asked Openhandle not to serve it.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request failed internally.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The service is temporarily unavailable.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}}},"security":[{"OpenhandleKey":[]}],"summary":"Get clip metadata","tags":["Instagram","Entity"],"x-openhandle-operation":"instagram.post.clip.metadata.get","x-openhandle-sdk":{"operation":"get","paginated":false,"path":"instagram.post.clipMetadata.get","scope":[{"name":"instagram"},{"name":"post","parameter":"identifier","reference":"post"},{"name":"clipMetadata"}]},"x-openhandle-test-data":{"catalogUrl":"/v1/test-data?operation=instagram.post.clip.metadata.get","contentHash":"sha256:7794275e0d6f248bb315a82bf631385a86ae70d2957dd815951fce7615602735","datasetVersion":"2026-10-27.2","example":{"comment":"synthetic comment","identifier":"910100000001","media_id":"910100000001","query":"synthetic"}}}},"/v1/instagram/posts/{identifier}/comment-metadata":{"get":{"description":"Get comment metadata from public Instagram data. Test and Live use the same route, parameters, response schema, pagination, and errors. In Test, null means unavailable, not zero.","operationId":"Instagram_post_comment_metadata_get","parameters":[{"description":"Public resource reference. Profile paths accept a username with an @ prefix, such as @openai, or the stable platform ID. Post paths accept the platform post ID or shortcode.","example":"910100000001","in":"path","name":"identifier","required":true,"schema":{"minLength":1,"type":"string"}},{"description":"Maximum accepted data age. The default is 24h.","example":"24h","in":"query","name":"freshness","required":false,"schema":{"default":"24h","enum":["live","24h","7d","30d"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/SuccessEnvelope"},{"properties":{"data":{"$ref":"#/components/schemas/InstagramCommentMetadata"}},"required":["data"],"type":"object"}]}}},"description":"A successful Test or Live response.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The locator, cursor, or query is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The API key is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Live billing does not permit this request.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource is private or workspace API access is security-suspended.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource does not exist.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer serves this data. Retrying fails the same way.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request rate limit was exceeded.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"451":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The owner of this profile asked Openhandle not to serve it.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request failed internally.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The service is temporarily unavailable.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}}},"security":[{"OpenhandleKey":[]}],"summary":"Get comment metadata","tags":["Instagram","Entity"],"x-openhandle-operation":"instagram.post.comment.metadata.get","x-openhandle-sdk":{"operation":"get","paginated":false,"path":"instagram.post.commentMetadata.get","scope":[{"name":"instagram"},{"name":"post","parameter":"identifier","reference":"post"},{"name":"commentMetadata"}]},"x-openhandle-test-data":{"catalogUrl":"/v1/test-data?operation=instagram.post.comment.metadata.get","contentHash":"sha256:7794275e0d6f248bb315a82bf631385a86ae70d2957dd815951fce7615602735","datasetVersion":"2026-10-27.2","example":{"comment":"synthetic comment","identifier":"910100000001","media_id":"910100000001","query":"synthetic"}}}},"/v1/instagram/posts/{identifier}/comment-moderation":{"get":{"description":"Check comment moderation from public Instagram data. Test and Live use the same route, parameters, response schema, pagination, and errors. In Test, null means unavailable, not zero.","operationId":"Instagram_post_comment_moderation_get","parameters":[{"description":"Public resource reference. Profile paths accept a username with an @ prefix, such as @openai, or the stable platform ID. Post paths accept the platform post ID or shortcode.","example":"910100000001","in":"path","name":"identifier","required":true,"schema":{"minLength":1,"type":"string"}},{"description":"Comment text to check.","example":"synthetic comment","in":"query","name":"comment","required":true,"schema":{"minLength":1,"type":"string"}},{"description":"Maximum accepted data age. The default is 24h.","example":"24h","in":"query","name":"freshness","required":false,"schema":{"default":"24h","enum":["live","24h","7d","30d"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/SuccessEnvelope"},{"properties":{"data":{"$ref":"#/components/schemas/InstagramCommentModeration"}},"required":["data"],"type":"object"}]}}},"description":"A successful Test or Live response.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The locator, cursor, or query is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The API key is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Live billing does not permit this request.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource is private or workspace API access is security-suspended.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource does not exist.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer serves this data. Retrying fails the same way.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request rate limit was exceeded.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"451":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The owner of this profile asked Openhandle not to serve it.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request failed internally.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The service is temporarily unavailable.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}}},"security":[{"OpenhandleKey":[]}],"summary":"Check comment moderation","tags":["Instagram","Entity"],"x-openhandle-operation":"instagram.post.comment.moderation.get","x-openhandle-sdk":{"operation":"get","paginated":false,"path":"instagram.post.commentModeration.get","scope":[{"name":"instagram"},{"name":"post","parameter":"identifier","reference":"post"},{"name":"commentModeration"}]},"x-openhandle-test-data":{"catalogUrl":"/v1/test-data?operation=instagram.post.comment.moderation.get","contentHash":"sha256:7794275e0d6f248bb315a82bf631385a86ae70d2957dd815951fce7615602735","datasetVersion":"2026-10-27.2","example":{"comment":"synthetic comment","identifier":"910100000001","media_id":"910100000001","query":"synthetic"}}}},"/v1/instagram/posts/{identifier}/comments":{"get":{"description":"List post comments by a canonical platform identifier. URLs must be converted before calling a data endpoint. Test and Live use the same route, parameters, response schema, pagination, and errors. In Test, null means unavailable, not zero.","operationId":"instagramPostCommentsList","parameters":[{"description":"Public resource reference. Profile paths accept a username with an @ prefix, such as @openai, or the stable platform ID. Post paths accept the platform post ID or shortcode.","example":"910100000001","in":"path","name":"identifier","required":true,"schema":{"minLength":1,"type":"string"}},{"description":"Maximum accepted data age. The default is 24h.","example":"24h","in":"query","name":"freshness","required":false,"schema":{"default":"24h","enum":["live","24h","7d","30d"],"type":"string"}},{"description":"Opaque cursor returned by the previous page.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/SuccessEnvelope"},{"properties":{"data":{"items":{"$ref":"#/components/schemas/InstagramComment"},"type":"array"}},"required":["data","meta"],"type":"object"}]}}},"description":"A successful Test or Live response.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The locator, cursor, or query is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The API key is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Live billing does not permit this request.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource is private or workspace API access is security-suspended.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource does not exist.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer accepts this cursor. Restart pagination from the first page.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer serves this data. Retrying fails the same way.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request rate limit was exceeded.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"451":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The owner of this profile asked Openhandle not to serve it.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request failed internally.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The service is temporarily unavailable.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}}},"security":[{"OpenhandleKey":[]}],"summary":"List post comments","tags":["Instagram","Post"],"x-openhandle-operation":"instagram.post.comments.list","x-openhandle-sdk":{"operation":"list","paginated":true,"path":"instagram.post.comments.list","scope":[{"name":"instagram"},{"name":"post","parameter":"identifier","reference":"post"},{"name":"comments"}]},"x-openhandle-test-data":{"catalogUrl":"/v1/test-data?operation=instagram.post.comments.list","contentHash":"sha256:7794275e0d6f248bb315a82bf631385a86ae70d2957dd815951fce7615602735","datasetVersion":"2026-10-27.2","example":{"identifier":"910100000001"}}}},"/v1/instagram/posts/{identifier}/comments/{comment_id}/replies":{"get":{"description":"Return a stable page of replies for one comment. Use find_test_data to discover compatible post and comment IDs. Test and Live use the same route, parameters, response schema, pagination, and errors. In Test, null means unavailable, not zero.","operationId":"instagramCommentRepliesList","parameters":[{"description":"Public resource reference. Profile paths accept a username with an @ prefix, such as @openai, or the stable platform ID. Post paths accept the platform post ID or shortcode.","example":"910100000001","in":"path","name":"identifier","required":true,"schema":{"minLength":1,"type":"string"}},{"description":"Opaque native comment ID.","example":"910200000001","in":"path","name":"comment_id","required":true,"schema":{"minLength":1,"type":"string"}},{"description":"Maximum accepted data age. The default is 24h.","example":"24h","in":"query","name":"freshness","required":false,"schema":{"default":"24h","enum":["live","24h","7d","30d"],"type":"string"}},{"description":"Opaque cursor returned by the previous page.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/SuccessEnvelope"},{"properties":{"data":{"items":{"$ref":"#/components/schemas/InstagramComment"},"type":"array"}},"required":["data","meta"],"type":"object"}]}}},"description":"A successful Test or Live response.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The locator, cursor, or query is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The API key is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Live billing does not permit this request.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource is private or workspace API access is security-suspended.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource does not exist.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer accepts this cursor. Restart pagination from the first page.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer serves this data. Retrying fails the same way.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request rate limit was exceeded.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"451":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The owner of this profile asked Openhandle not to serve it.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request failed internally.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The service is temporarily unavailable.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}}},"security":[{"OpenhandleKey":[]}],"summary":"List comment replies","tags":["Instagram","Comment"],"x-openhandle-operation":"instagram.comment.replies.list","x-openhandle-sdk":{"operation":"list","paginated":true,"path":"instagram.post.comment.replies.list","scope":[{"name":"instagram"},{"name":"post","parameter":"identifier","reference":"post"},{"name":"comment","parameter":"comment_id","reference":"comment"},{"name":"replies"}]},"x-openhandle-test-data":{"catalogUrl":"/v1/test-data?operation=instagram.comment.replies.list","contentHash":"sha256:7794275e0d6f248bb315a82bf631385a86ae70d2957dd815951fce7615602735","datasetVersion":"2026-10-27.2","example":{"comment_id":"910200000001","identifier":"910100000001","post_id":"910100000001"}}}},"/v1/instagram/posts/{identifier}/insights":{"get":{"description":"Get post insights from public Instagram data. Test and Live use the same route, parameters, response schema, pagination, and errors. In Test, null means unavailable, not zero.","operationId":"Instagram_post_insights_get","parameters":[{"description":"Public resource reference. Profile paths accept a username with an @ prefix, such as @openai, or the stable platform ID. Post paths accept the platform post ID or shortcode.","example":"910100000001","in":"path","name":"identifier","required":true,"schema":{"minLength":1,"type":"string"}},{"description":"Maximum accepted data age. The default is 24h.","example":"24h","in":"query","name":"freshness","required":false,"schema":{"default":"24h","enum":["live","24h","7d","30d"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/SuccessEnvelope"},{"properties":{"data":{"$ref":"#/components/schemas/InstagramPostInsight"}},"required":["data"],"type":"object"}]}}},"description":"A successful Test or Live response.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The locator, cursor, or query is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The API key is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Live billing does not permit this request.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource is private or workspace API access is security-suspended.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource does not exist.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer serves this data. Retrying fails the same way.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request rate limit was exceeded.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"451":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The owner of this profile asked Openhandle not to serve it.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request failed internally.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The service is temporarily unavailable.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}}},"security":[{"OpenhandleKey":[]}],"summary":"Get post insights","tags":["Instagram","Entity"],"x-openhandle-operation":"instagram.post.insights.get","x-openhandle-sdk":{"operation":"get","paginated":false,"path":"instagram.post.insights.get","scope":[{"name":"instagram"},{"name":"post","parameter":"identifier","reference":"post"},{"name":"insights"}]},"x-openhandle-test-data":{"catalogUrl":"/v1/test-data?operation=instagram.post.insights.get","contentHash":"sha256:7794275e0d6f248bb315a82bf631385a86ae70d2957dd815951fce7615602735","datasetVersion":"2026-10-27.2","example":{"comment":"synthetic comment","identifier":"910100000001","media_id":"910100000001","query":"synthetic"}}}},"/v1/instagram/posts/{identifier}/likers":{"get":{"description":"Return public profiles that liked an Instagram post. Test and Live use the same route, parameters, response schema, pagination, and errors. In Test, null means unavailable, not zero.","operationId":"instagramPostLikersList","parameters":[{"description":"Public resource reference. Profile paths accept a username with an @ prefix, such as @openai, or the stable platform ID. Post paths accept the platform post ID or shortcode.","example":"910100000001","in":"path","name":"identifier","required":true,"schema":{"minLength":1,"type":"string"}},{"description":"Maximum accepted data age. The default is 24h.","example":"24h","in":"query","name":"freshness","required":false,"schema":{"default":"24h","enum":["live","24h","7d","30d"],"type":"string"}},{"description":"Opaque cursor returned by the previous page.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/SuccessEnvelope"},{"properties":{"data":{"items":{"$ref":"#/components/schemas/InstagramProfile"},"type":"array"}},"required":["data","meta"],"type":"object"}]}}},"description":"A successful Test or Live response.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The locator, cursor, or query is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The API key is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Live billing does not permit this request.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource is private or workspace API access is security-suspended.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource does not exist.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer accepts this cursor. Restart pagination from the first page.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer serves this data. Retrying fails the same way.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request rate limit was exceeded.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"451":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The owner of this profile asked Openhandle not to serve it.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request failed internally.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The service is temporarily unavailable.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}}},"security":[{"OpenhandleKey":[]}],"summary":"List post likers","tags":["Instagram","Profile"],"x-openhandle-operation":"instagram.post.likers.list","x-openhandle-sdk":{"operation":"list","paginated":true,"path":"instagram.post.likers.list","scope":[{"name":"instagram"},{"name":"post","parameter":"identifier","reference":"post"},{"name":"likers"}]},"x-openhandle-test-data":{"catalogUrl":"/v1/test-data?operation=instagram.post.likers.list","contentHash":"sha256:7794275e0d6f248bb315a82bf631385a86ae70d2957dd815951fce7615602735","datasetVersion":"2026-10-27.2","example":{"identifier":"910100000001"}}}},"/v1/instagram/posts/{identifier}/oembed":{"get":{"description":"Get post oEmbed data from public Instagram data. Test and Live use the same route, parameters, response schema, pagination, and errors. In Test, null means unavailable, not zero.","operationId":"Instagram_post_oembed_get","parameters":[{"description":"Public resource reference. Profile paths accept a username with an @ prefix, such as @openai, or the stable platform ID. Post paths accept the platform post ID or shortcode.","example":"910100000001","in":"path","name":"identifier","required":true,"schema":{"minLength":1,"type":"string"}},{"description":"Maximum accepted data age. The default is 24h.","example":"24h","in":"query","name":"freshness","required":false,"schema":{"default":"24h","enum":["live","24h","7d","30d"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/SuccessEnvelope"},{"properties":{"data":{"$ref":"#/components/schemas/InstagramOEmbed"}},"required":["data"],"type":"object"}]}}},"description":"A successful Test or Live response.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The locator, cursor, or query is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The API key is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Live billing does not permit this request.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource is private or workspace API access is security-suspended.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource does not exist.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer serves this data. Retrying fails the same way.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request rate limit was exceeded.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"451":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The owner of this profile asked Openhandle not to serve it.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request failed internally.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The service is temporarily unavailable.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}}},"security":[{"OpenhandleKey":[]}],"summary":"Get post oEmbed data","tags":["Instagram","Entity"],"x-openhandle-operation":"instagram.post.oembed.get","x-openhandle-sdk":{"operation":"get","paginated":false,"path":"instagram.post.oembed.get","scope":[{"name":"instagram"},{"name":"post","parameter":"identifier","reference":"post"},{"name":"oembed"}]},"x-openhandle-test-data":{"catalogUrl":"/v1/test-data?operation=instagram.post.oembed.get","contentHash":"sha256:7794275e0d6f248bb315a82bf631385a86ae70d2957dd815951fce7615602735","datasetVersion":"2026-10-27.2","example":{"comment":"synthetic comment","identifier":"910100000001","media_id":"910100000001","query":"synthetic"}}}},"/v1/instagram/posts/{identifier}/tagged-users":{"get":{"description":"Return public profiles tagged in an Instagram post. Test and Live use the same route, parameters, response schema, pagination, and errors. In Test, null means unavailable, not zero.","operationId":"instagramPostTaggedUsersList","parameters":[{"description":"Public resource reference. Profile paths accept a username with an @ prefix, such as @openai, or the stable platform ID. Post paths accept the platform post ID or shortcode.","example":"910100000001","in":"path","name":"identifier","required":true,"schema":{"minLength":1,"type":"string"}},{"description":"Maximum accepted data age. The default is 24h.","example":"24h","in":"query","name":"freshness","required":false,"schema":{"default":"24h","enum":["live","24h","7d","30d"],"type":"string"}},{"description":"Opaque cursor returned by the previous page.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/SuccessEnvelope"},{"properties":{"data":{"items":{"$ref":"#/components/schemas/InstagramUserTag"},"type":"array"}},"required":["data","meta"],"type":"object"}]}}},"description":"A successful Test or Live response.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The locator, cursor, or query is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The API key is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Live billing does not permit this request.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource is private or workspace API access is security-suspended.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource does not exist.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer accepts this cursor. Restart pagination from the first page.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer serves this data. Retrying fails the same way.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request rate limit was exceeded.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"451":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The owner of this profile asked Openhandle not to serve it.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request failed internally.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The service is temporarily unavailable.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}}},"security":[{"OpenhandleKey":[]}],"summary":"List tagged users","tags":["Instagram","Profile"],"x-openhandle-operation":"instagram.post.tagged.users.list","x-openhandle-sdk":{"operation":"list","paginated":true,"path":"instagram.post.taggedUsers.list","scope":[{"name":"instagram"},{"name":"post","parameter":"identifier","reference":"post"},{"name":"taggedUsers"}]},"x-openhandle-test-data":{"catalogUrl":"/v1/test-data?operation=instagram.post.tagged.users.list","contentHash":"sha256:7794275e0d6f248bb315a82bf631385a86ae70d2957dd815951fce7615602735","datasetVersion":"2026-10-27.2","example":{"identifier":"910100000001"}}}},"/v1/instagram/posts/{identifier}/template":{"get":{"description":"Get post template from public Instagram data. Test and Live use the same route, parameters, response schema, pagination, and errors. In Test, null means unavailable, not zero.","operationId":"Instagram_post_template_get","parameters":[{"description":"Public resource reference. Profile paths accept a username with an @ prefix, such as @openai, or the stable platform ID. Post paths accept the platform post ID or shortcode.","example":"910100000001","in":"path","name":"identifier","required":true,"schema":{"minLength":1,"type":"string"}},{"description":"Maximum accepted data age. The default is 24h.","example":"24h","in":"query","name":"freshness","required":false,"schema":{"default":"24h","enum":["live","24h","7d","30d"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/SuccessEnvelope"},{"properties":{"data":{"$ref":"#/components/schemas/InstagramTemplate"}},"required":["data"],"type":"object"}]}}},"description":"A successful Test or Live response.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The locator, cursor, or query is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The API key is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Live billing does not permit this request.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource is private or workspace API access is security-suspended.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource does not exist.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer serves this data. Retrying fails the same way.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request rate limit was exceeded.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"451":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The owner of this profile asked Openhandle not to serve it.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request failed internally.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The service is temporarily unavailable.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}}},"security":[{"OpenhandleKey":[]}],"summary":"Get post template","tags":["Instagram","Entity"],"x-openhandle-operation":"instagram.post.template.get","x-openhandle-sdk":{"operation":"get","paginated":false,"path":"instagram.post.template.get","scope":[{"name":"instagram"},{"name":"post","parameter":"identifier","reference":"post"},{"name":"template"}]},"x-openhandle-test-data":{"catalogUrl":"/v1/test-data?operation=instagram.post.template.get","contentHash":"sha256:7794275e0d6f248bb315a82bf631385a86ae70d2957dd815951fce7615602735","datasetVersion":"2026-10-27.2","example":{"comment":"synthetic comment","identifier":"910100000001","media_id":"910100000001","query":"synthetic"}}}},"/v1/instagram/profiles/{identifier}":{"get":{"description":"Return one public profile. Use @username or a platform ID as the identifier. Test and Live use the same route, parameters, response schema, pagination, and errors. In Test, null means unavailable, not zero.","operationId":"instagramProfileGet","parameters":[{"description":"Public resource reference. Profile paths accept a username with an @ prefix, such as @openai, or the stable platform ID. Post paths accept the platform post ID or shortcode.","example":"@northstar_forge_test","in":"path","name":"identifier","required":true,"schema":{"minLength":1,"type":"string"}},{"description":"Maximum accepted data age. The default is 24h.","example":"24h","in":"query","name":"freshness","required":false,"schema":{"default":"24h","enum":["live","24h","7d","30d"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/SuccessEnvelope"},{"properties":{"data":{"$ref":"#/components/schemas/InstagramProfile"}},"required":["data"],"type":"object"}]}}},"description":"A successful Test or Live response.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The locator, cursor, or query is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The API key is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Live billing does not permit this request.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource is private or workspace API access is security-suspended.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource does not exist.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer serves this data. Retrying fails the same way.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request rate limit was exceeded.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"451":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The owner of this profile asked Openhandle not to serve it.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request failed internally.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The service is temporarily unavailable.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}}},"security":[{"OpenhandleKey":[]}],"summary":"Get a profile","tags":["Instagram","Profile"],"x-openhandle-operation":"instagram.profile.get","x-openhandle-sdk":{"operation":"get","paginated":false,"path":"instagram.profile.get","scope":[{"name":"instagram"},{"name":"profile","parameter":"identifier","reference":"profile"}]},"x-openhandle-test-data":{"catalogUrl":"/v1/test-data?operation=instagram.profile.get","contentHash":"sha256:7794275e0d6f248bb315a82bf631385a86ae70d2957dd815951fce7615602735","datasetVersion":"2026-10-27.2","example":{"identifier":"@northstar_forge_test"}}}},"/v1/instagram/profiles/{identifier}/about":{"get":{"description":"Get profile about information from public Instagram data. Test and Live use the same route, parameters, response schema, pagination, and errors. In Test, null means unavailable, not zero.","operationId":"Instagram_profile_about_get","parameters":[{"description":"Public resource reference. Profile paths accept a username with an @ prefix, such as @openai, or the stable platform ID. Post paths accept the platform post ID or shortcode.","example":"@northstar_forge_test","in":"path","name":"identifier","required":true,"schema":{"minLength":1,"type":"string"}},{"description":"Maximum accepted data age. The default is 24h.","example":"24h","in":"query","name":"freshness","required":false,"schema":{"default":"24h","enum":["live","24h","7d","30d"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/SuccessEnvelope"},{"properties":{"data":{"$ref":"#/components/schemas/InstagramProfileAbout"}},"required":["data"],"type":"object"}]}}},"description":"A successful Test or Live response.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The locator, cursor, or query is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The API key is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Live billing does not permit this request.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource is private or workspace API access is security-suspended.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource does not exist.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer serves this data. Retrying fails the same way.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request rate limit was exceeded.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"451":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The owner of this profile asked Openhandle not to serve it.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request failed internally.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The service is temporarily unavailable.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}}},"security":[{"OpenhandleKey":[]}],"summary":"Get profile about information","tags":["Instagram","Entity"],"x-openhandle-operation":"instagram.profile.about.get","x-openhandle-sdk":{"operation":"get","paginated":false,"path":"instagram.profile.about.get","scope":[{"name":"instagram"},{"name":"profile","parameter":"identifier","reference":"profile"},{"name":"about"}]},"x-openhandle-test-data":{"catalogUrl":"/v1/test-data?operation=instagram.profile.about.get","contentHash":"sha256:7794275e0d6f248bb315a82bf631385a86ae70d2957dd815951fce7615602735","datasetVersion":"2026-10-27.2","example":{"comment":"synthetic comment","identifier":"@northstar_forge_test","media_id":"910100000001","query":"synthetic"}}}},"/v1/instagram/profiles/{identifier}/business-recommendations":{"get":{"description":"List business recommendations from public Instagram data. Test and Live use the same route, parameters, response schema, pagination, and errors. In Test, null means unavailable, not zero.","operationId":"Instagram_profile_business_recommendations_list","parameters":[{"description":"Public resource reference. Profile paths accept a username with an @ prefix, such as @openai, or the stable platform ID. Post paths accept the platform post ID or shortcode.","example":"@northstar_forge_test","in":"path","name":"identifier","required":true,"schema":{"minLength":1,"type":"string"}},{"description":"Maximum accepted data age. The default is 24h.","example":"24h","in":"query","name":"freshness","required":false,"schema":{"default":"24h","enum":["live","24h","7d","30d"],"type":"string"}},{"description":"Opaque cursor returned by the previous page.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/SuccessEnvelope"},{"properties":{"data":{"items":{"$ref":"#/components/schemas/InstagramProfileSummary"},"type":"array"}},"required":["data","meta"],"type":"object"}]}}},"description":"A successful Test or Live response.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The locator, cursor, or query is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The API key is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Live billing does not permit this request.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource is private or workspace API access is security-suspended.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource does not exist.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer accepts this cursor. Restart pagination from the first page.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer serves this data. Retrying fails the same way.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request rate limit was exceeded.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"451":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The owner of this profile asked Openhandle not to serve it.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request failed internally.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The service is temporarily unavailable.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}}},"security":[{"OpenhandleKey":[]}],"summary":"List business recommendations","tags":["Instagram","Entity"],"x-openhandle-operation":"instagram.profile.business.recommendations.list","x-openhandle-sdk":{"operation":"list","paginated":true,"path":"instagram.profile.businessRecommendations.list","scope":[{"name":"instagram"},{"name":"profile","parameter":"identifier","reference":"profile"},{"name":"businessRecommendations"}]},"x-openhandle-test-data":{"catalogUrl":"/v1/test-data?operation=instagram.profile.business.recommendations.list","contentHash":"sha256:7794275e0d6f248bb315a82bf631385a86ae70d2957dd815951fce7615602735","datasetVersion":"2026-10-27.2","example":{"comment":"synthetic comment","identifier":"@northstar_forge_test","media_id":"910100000001","query":"synthetic"}}}},"/v1/instagram/profiles/{identifier}/followers":{"get":{"description":"Return a cursor-paginated collection of Instagram profiles. Test and Live use the same route, parameters, response schema, pagination, and errors. In Test, null means unavailable, not zero.","operationId":"instagramProfileFollowersList","parameters":[{"description":"Public resource reference. Profile paths accept a username with an @ prefix, such as @openai, or the stable platform ID. Post paths accept the platform post ID or shortcode.","example":"@northstar_forge_test","in":"path","name":"identifier","required":true,"schema":{"minLength":1,"type":"string"}},{"description":"Maximum accepted data age. The default is 24h.","example":"24h","in":"query","name":"freshness","required":false,"schema":{"default":"24h","enum":["live","24h","7d","30d"],"type":"string"}},{"description":"Opaque cursor returned by the previous page.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/SuccessEnvelope"},{"properties":{"data":{"items":{"$ref":"#/components/schemas/InstagramProfile"},"type":"array"}},"required":["data","meta"],"type":"object"}]}}},"description":"A successful Test or Live response.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The locator, cursor, or query is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The API key is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Live billing does not permit this request.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource is private or workspace API access is security-suspended.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource does not exist.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer accepts this cursor. Restart pagination from the first page.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer serves this data. Retrying fails the same way.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request rate limit was exceeded.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"451":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The owner of this profile asked Openhandle not to serve it.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request failed internally.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The service is temporarily unavailable.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}}},"security":[{"OpenhandleKey":[]}],"summary":"List profile followers","tags":["Instagram","Profile"],"x-openhandle-operation":"instagram.profile.followers.list","x-openhandle-sdk":{"operation":"list","paginated":true,"path":"instagram.profile.followers.list","scope":[{"name":"instagram"},{"name":"profile","parameter":"identifier","reference":"profile"},{"name":"followers"}]},"x-openhandle-test-data":{"catalogUrl":"/v1/test-data?operation=instagram.profile.followers.list","contentHash":"sha256:7794275e0d6f248bb315a82bf631385a86ae70d2957dd815951fce7615602735","datasetVersion":"2026-10-27.2","example":{"identifier":"@northstar_forge_test"}}}},"/v1/instagram/profiles/{identifier}/followers/search":{"get":{"description":"Search within a public profile's followers collection. Test and Live use the same route, parameters, response schema, pagination, and errors. In Test, null means unavailable, not zero.","operationId":"instagramProfileFollowersSearch","parameters":[{"description":"Public resource reference. Profile paths accept a username with an @ prefix, such as @openai, or the stable platform ID. Post paths accept the platform post ID or shortcode.","example":"@northstar_forge_test","in":"path","name":"identifier","required":true,"schema":{"minLength":1,"type":"string"}},{"description":"Public search query.","example":"synthetic","in":"query","name":"q","required":true,"schema":{"minLength":1,"type":"string"}},{"description":"Maximum accepted data age. The default is 24h.","example":"24h","in":"query","name":"freshness","required":false,"schema":{"default":"24h","enum":["live","24h","7d","30d"],"type":"string"}},{"description":"Opaque cursor returned by the previous page.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/SuccessEnvelope"},{"properties":{"data":{"items":{"$ref":"#/components/schemas/InstagramProfile"},"type":"array"}},"required":["data","meta"],"type":"object"}]}}},"description":"A successful Test or Live response.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The locator, cursor, or query is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The API key is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Live billing does not permit this request.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource is private or workspace API access is security-suspended.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource does not exist.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer accepts this cursor. Restart pagination from the first page.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer serves this data. Retrying fails the same way.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request rate limit was exceeded.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"451":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The owner of this profile asked Openhandle not to serve it.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request failed internally.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The service is temporarily unavailable.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}}},"security":[{"OpenhandleKey":[]}],"summary":"Search profile followers","tags":["Instagram","Profile"],"x-openhandle-operation":"instagram.profile.followers.search","x-openhandle-sdk":{"operation":"search","paginated":true,"path":"instagram.profile.followers.search","scope":[{"name":"instagram"},{"name":"profile","parameter":"identifier","reference":"profile"},{"name":"followers"}]},"x-openhandle-test-data":{"catalogUrl":"/v1/test-data?operation=instagram.profile.followers.search","contentHash":"sha256:7794275e0d6f248bb315a82bf631385a86ae70d2957dd815951fce7615602735","datasetVersion":"2026-10-27.2","example":{"identifier":"@northstar_forge_test","query":"synthetic"}}}},"/v1/instagram/profiles/{identifier}/following":{"get":{"description":"Return a cursor-paginated collection of Instagram profiles. Test and Live use the same route, parameters, response schema, pagination, and errors. In Test, null means unavailable, not zero.","operationId":"instagramProfileFollowingList","parameters":[{"description":"Public resource reference. Profile paths accept a username with an @ prefix, such as @openai, or the stable platform ID. Post paths accept the platform post ID or shortcode.","example":"@northstar_forge_test","in":"path","name":"identifier","required":true,"schema":{"minLength":1,"type":"string"}},{"description":"Maximum accepted data age. The default is 24h.","example":"24h","in":"query","name":"freshness","required":false,"schema":{"default":"24h","enum":["live","24h","7d","30d"],"type":"string"}},{"description":"Opaque cursor returned by the previous page.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/SuccessEnvelope"},{"properties":{"data":{"items":{"$ref":"#/components/schemas/InstagramProfile"},"type":"array"}},"required":["data","meta"],"type":"object"}]}}},"description":"A successful Test or Live response.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The locator, cursor, or query is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The API key is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Live billing does not permit this request.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource is private or workspace API access is security-suspended.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource does not exist.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer accepts this cursor. Restart pagination from the first page.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer serves this data. Retrying fails the same way.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request rate limit was exceeded.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"451":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The owner of this profile asked Openhandle not to serve it.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request failed internally.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The service is temporarily unavailable.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}}},"security":[{"OpenhandleKey":[]}],"summary":"List profile following","tags":["Instagram","Profile"],"x-openhandle-operation":"instagram.profile.following.list","x-openhandle-sdk":{"operation":"list","paginated":true,"path":"instagram.profile.following.list","scope":[{"name":"instagram"},{"name":"profile","parameter":"identifier","reference":"profile"},{"name":"following"}]},"x-openhandle-test-data":{"catalogUrl":"/v1/test-data?operation=instagram.profile.following.list","contentHash":"sha256:7794275e0d6f248bb315a82bf631385a86ae70d2957dd815951fce7615602735","datasetVersion":"2026-10-27.2","example":{"identifier":"@northstar_forge_test"}}}},"/v1/instagram/profiles/{identifier}/following/search":{"get":{"description":"Search within a public profile's following collection. Test and Live use the same route, parameters, response schema, pagination, and errors. In Test, null means unavailable, not zero.","operationId":"instagramProfileFollowingSearch","parameters":[{"description":"Public resource reference. Profile paths accept a username with an @ prefix, such as @openai, or the stable platform ID. Post paths accept the platform post ID or shortcode.","example":"@northstar_forge_test","in":"path","name":"identifier","required":true,"schema":{"minLength":1,"type":"string"}},{"description":"Public search query.","example":"synthetic","in":"query","name":"q","required":true,"schema":{"minLength":1,"type":"string"}},{"description":"Maximum accepted data age. The default is 24h.","example":"24h","in":"query","name":"freshness","required":false,"schema":{"default":"24h","enum":["live","24h","7d","30d"],"type":"string"}},{"description":"Opaque cursor returned by the previous page.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/SuccessEnvelope"},{"properties":{"data":{"items":{"$ref":"#/components/schemas/InstagramProfile"},"type":"array"}},"required":["data","meta"],"type":"object"}]}}},"description":"A successful Test or Live response.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The locator, cursor, or query is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The API key is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Live billing does not permit this request.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource is private or workspace API access is security-suspended.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource does not exist.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer accepts this cursor. Restart pagination from the first page.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer serves this data. Retrying fails the same way.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request rate limit was exceeded.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"451":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The owner of this profile asked Openhandle not to serve it.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request failed internally.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The service is temporarily unavailable.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}}},"security":[{"OpenhandleKey":[]}],"summary":"Search profile following","tags":["Instagram","Profile"],"x-openhandle-operation":"instagram.profile.following.search","x-openhandle-sdk":{"operation":"search","paginated":true,"path":"instagram.profile.following.search","scope":[{"name":"instagram"},{"name":"profile","parameter":"identifier","reference":"profile"},{"name":"following"}]},"x-openhandle-test-data":{"catalogUrl":"/v1/test-data?operation=instagram.profile.following.search","contentHash":"sha256:7794275e0d6f248bb315a82bf631385a86ae70d2957dd815951fce7615602735","datasetVersion":"2026-10-27.2","example":{"identifier":"@northstar_forge_test","query":"synthetic"}}}},"/v1/instagram/profiles/{identifier}/highlights":{"get":{"description":"List profile highlights from public Instagram data. Test and Live use the same route, parameters, response schema, pagination, and errors. In Test, null means unavailable, not zero.","operationId":"Instagram_profile_highlights_list","parameters":[{"description":"Public resource reference. Profile paths accept a username with an @ prefix, such as @openai, or the stable platform ID. Post paths accept the platform post ID or shortcode.","example":"@northstar_forge_test","in":"path","name":"identifier","required":true,"schema":{"minLength":1,"type":"string"}},{"description":"Maximum accepted data age. The default is 24h.","example":"24h","in":"query","name":"freshness","required":false,"schema":{"default":"24h","enum":["live","24h","7d","30d"],"type":"string"}},{"description":"Opaque cursor returned by the previous page.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/SuccessEnvelope"},{"properties":{"data":{"items":{"$ref":"#/components/schemas/InstagramHighlight"},"type":"array"}},"required":["data","meta"],"type":"object"}]}}},"description":"A successful Test or Live response.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The locator, cursor, or query is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The API key is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Live billing does not permit this request.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource is private or workspace API access is security-suspended.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource does not exist.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer accepts this cursor. Restart pagination from the first page.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer serves this data. Retrying fails the same way.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request rate limit was exceeded.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"451":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The owner of this profile asked Openhandle not to serve it.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request failed internally.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The service is temporarily unavailable.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}}},"security":[{"OpenhandleKey":[]}],"summary":"List profile highlights","tags":["Instagram","Entity"],"x-openhandle-operation":"instagram.profile.highlights.list","x-openhandle-sdk":{"operation":"list","paginated":true,"path":"instagram.profile.highlights.list","scope":[{"name":"instagram"},{"name":"profile","parameter":"identifier","reference":"profile"},{"name":"highlights"}]},"x-openhandle-test-data":{"catalogUrl":"/v1/test-data?operation=instagram.profile.highlights.list","contentHash":"sha256:7794275e0d6f248bb315a82bf631385a86ae70d2957dd815951fce7615602735","datasetVersion":"2026-10-27.2","example":{"comment":"synthetic comment","identifier":"@northstar_forge_test","media_id":"910100000001","query":"synthetic"}}}},"/v1/instagram/profiles/{identifier}/pinned-posts":{"get":{"description":"Return a cursor-paginated collection of a public Instagram profile's pinned posts. Test and Live use the same route, parameters, response schema, pagination, and errors. In Test, null means unavailable, not zero.","operationId":"instagramProfilePinned_postsList","parameters":[{"description":"Public resource reference. Profile paths accept a username with an @ prefix, such as @openai, or the stable platform ID. Post paths accept the platform post ID or shortcode.","example":"@northstar_forge_test","in":"path","name":"identifier","required":true,"schema":{"minLength":1,"type":"string"}},{"description":"Maximum accepted data age. The default is 24h.","example":"24h","in":"query","name":"freshness","required":false,"schema":{"default":"24h","enum":["live","24h","7d","30d"],"type":"string"}},{"description":"Opaque cursor returned by the previous page.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/SuccessEnvelope"},{"properties":{"data":{"items":{"$ref":"#/components/schemas/InstagramPost"},"type":"array"}},"required":["data","meta"],"type":"object"}]}}},"description":"A successful Test or Live response.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The locator, cursor, or query is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The API key is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Live billing does not permit this request.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource is private or workspace API access is security-suspended.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource does not exist.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer accepts this cursor. Restart pagination from the first page.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer serves this data. Retrying fails the same way.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request rate limit was exceeded.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"451":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The owner of this profile asked Openhandle not to serve it.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request failed internally.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The service is temporarily unavailable.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}}},"security":[{"OpenhandleKey":[]}],"summary":"List profile pinned posts","tags":["Instagram","Post"],"x-openhandle-operation":"instagram.profile.pinned.posts.list","x-openhandle-sdk":{"operation":"list","paginated":true,"path":"instagram.profile.pinnedPosts.list","scope":[{"name":"instagram"},{"name":"profile","parameter":"identifier","reference":"profile"},{"name":"pinnedPosts"}]},"x-openhandle-test-data":{"catalogUrl":"/v1/test-data?operation=instagram.profile.pinned.posts.list","contentHash":"sha256:7794275e0d6f248bb315a82bf631385a86ae70d2957dd815951fce7615602735","datasetVersion":"2026-10-27.2","example":{"identifier":"@northstar_forge_test"}}}},"/v1/instagram/profiles/{identifier}/posts":{"get":{"description":"Return a stable page of posts for one public profile. Test and Live use the same route, parameters, response schema, pagination, and errors. In Test, null means unavailable, not zero.","operationId":"instagramProfilePostsList","parameters":[{"description":"Public resource reference. Profile paths accept a username with an @ prefix, such as @openai, or the stable platform ID. Post paths accept the platform post ID or shortcode.","example":"@northstar_forge_test","in":"path","name":"identifier","required":true,"schema":{"minLength":1,"type":"string"}},{"description":"Maximum accepted data age. The default is 24h.","example":"24h","in":"query","name":"freshness","required":false,"schema":{"default":"24h","enum":["live","24h","7d","30d"],"type":"string"}},{"description":"Opaque cursor returned by the previous page.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}},{"description":"Return posts captured at or after this RFC 3339 timestamp.","in":"query","name":"since","required":false,"schema":{"format":"date-time","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/SuccessEnvelope"},{"properties":{"data":{"items":{"$ref":"#/components/schemas/InstagramPost"},"type":"array"}},"required":["data","meta"],"type":"object"}]}}},"description":"A successful Test or Live response.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The locator, cursor, or query is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The API key is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Live billing does not permit this request.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource is private or workspace API access is security-suspended.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource does not exist.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer accepts this cursor. Restart pagination from the first page.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer serves this data. Retrying fails the same way.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request rate limit was exceeded.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"451":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The owner of this profile asked Openhandle not to serve it.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request failed internally.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The service is temporarily unavailable.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}}},"security":[{"OpenhandleKey":[]}],"summary":"List profile posts","tags":["Instagram","Profile"],"x-openhandle-operation":"instagram.profile.posts.list","x-openhandle-sdk":{"operation":"list","paginated":true,"path":"instagram.profile.posts.list","scope":[{"name":"instagram"},{"name":"profile","parameter":"identifier","reference":"profile"},{"name":"posts"}]},"x-openhandle-test-data":{"catalogUrl":"/v1/test-data?operation=instagram.profile.posts.list","contentHash":"sha256:7794275e0d6f248bb315a82bf631385a86ae70d2957dd815951fce7615602735","datasetVersion":"2026-10-27.2","example":{"identifier":"@northstar_forge_test"}}}},"/v1/instagram/profiles/{identifier}/reels":{"get":{"description":"Return a cursor-paginated collection of a public Instagram profile's reels. Test and Live use the same route, parameters, response schema, pagination, and errors. In Test, null means unavailable, not zero.","operationId":"instagramProfileReelsList","parameters":[{"description":"Public resource reference. Profile paths accept a username with an @ prefix, such as @openai, or the stable platform ID. Post paths accept the platform post ID or shortcode.","example":"@northstar_forge_test","in":"path","name":"identifier","required":true,"schema":{"minLength":1,"type":"string"}},{"description":"Maximum accepted data age. The default is 24h.","example":"24h","in":"query","name":"freshness","required":false,"schema":{"default":"24h","enum":["live","24h","7d","30d"],"type":"string"}},{"description":"Opaque cursor returned by the previous page.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/SuccessEnvelope"},{"properties":{"data":{"items":{"$ref":"#/components/schemas/InstagramPost"},"type":"array"}},"required":["data","meta"],"type":"object"}]}}},"description":"A successful Test or Live response.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The locator, cursor, or query is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The API key is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Live billing does not permit this request.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource is private or workspace API access is security-suspended.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource does not exist.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer accepts this cursor. Restart pagination from the first page.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer serves this data. Retrying fails the same way.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request rate limit was exceeded.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"451":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The owner of this profile asked Openhandle not to serve it.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request failed internally.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The service is temporarily unavailable.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}}},"security":[{"OpenhandleKey":[]}],"summary":"List profile reels","tags":["Instagram","Post"],"x-openhandle-operation":"instagram.profile.reels.list","x-openhandle-sdk":{"operation":"list","paginated":true,"path":"instagram.profile.reels.list","scope":[{"name":"instagram"},{"name":"profile","parameter":"identifier","reference":"profile"},{"name":"reels"}]},"x-openhandle-test-data":{"catalogUrl":"/v1/test-data?operation=instagram.profile.reels.list","contentHash":"sha256:7794275e0d6f248bb315a82bf631385a86ae70d2957dd815951fce7615602735","datasetVersion":"2026-10-27.2","example":{"identifier":"@northstar_forge_test"}}}},"/v1/instagram/profiles/{identifier}/reposts":{"get":{"description":"Return a cursor-paginated collection of a public Instagram profile's reposts. Test and Live use the same route, parameters, response schema, pagination, and errors. In Test, null means unavailable, not zero.","operationId":"instagramProfileRepostsList","parameters":[{"description":"Public resource reference. Profile paths accept a username with an @ prefix, such as @openai, or the stable platform ID. Post paths accept the platform post ID or shortcode.","example":"@northstar_forge_test","in":"path","name":"identifier","required":true,"schema":{"minLength":1,"type":"string"}},{"description":"Maximum accepted data age. The default is 24h.","example":"24h","in":"query","name":"freshness","required":false,"schema":{"default":"24h","enum":["live","24h","7d","30d"],"type":"string"}},{"description":"Opaque cursor returned by the previous page.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/SuccessEnvelope"},{"properties":{"data":{"items":{"$ref":"#/components/schemas/InstagramPost"},"type":"array"}},"required":["data","meta"],"type":"object"}]}}},"description":"A successful Test or Live response.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The locator, cursor, or query is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The API key is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Live billing does not permit this request.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource is private or workspace API access is security-suspended.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource does not exist.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer accepts this cursor. Restart pagination from the first page.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer serves this data. Retrying fails the same way.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request rate limit was exceeded.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"451":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The owner of this profile asked Openhandle not to serve it.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request failed internally.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The service is temporarily unavailable.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}}},"security":[{"OpenhandleKey":[]}],"summary":"List profile reposts","tags":["Instagram","Post"],"x-openhandle-operation":"instagram.profile.reposts.list","x-openhandle-sdk":{"operation":"list","paginated":true,"path":"instagram.profile.reposts.list","scope":[{"name":"instagram"},{"name":"profile","parameter":"identifier","reference":"profile"},{"name":"reposts"}]},"x-openhandle-test-data":{"catalogUrl":"/v1/test-data?operation=instagram.profile.reposts.list","contentHash":"sha256:7794275e0d6f248bb315a82bf631385a86ae70d2957dd815951fce7615602735","datasetVersion":"2026-10-27.2","example":{"identifier":"@northstar_forge_test"}}}},"/v1/instagram/profiles/{identifier}/stories":{"get":{"description":"List profile stories from public Instagram data. Test and Live use the same route, parameters, response schema, pagination, and errors. In Test, null means unavailable, not zero.","operationId":"Instagram_profile_stories_list","parameters":[{"description":"Public resource reference. Profile paths accept a username with an @ prefix, such as @openai, or the stable platform ID. Post paths accept the platform post ID or shortcode.","example":"@northstar_forge_test","in":"path","name":"identifier","required":true,"schema":{"minLength":1,"type":"string"}},{"description":"Maximum accepted data age. The default is 24h.","example":"24h","in":"query","name":"freshness","required":false,"schema":{"default":"24h","enum":["live","24h","7d","30d"],"type":"string"}},{"description":"Opaque cursor returned by the previous page.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/SuccessEnvelope"},{"properties":{"data":{"items":{"$ref":"#/components/schemas/InstagramStory"},"type":"array"}},"required":["data","meta"],"type":"object"}]}}},"description":"A successful Test or Live response.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The locator, cursor, or query is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The API key is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Live billing does not permit this request.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource is private or workspace API access is security-suspended.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource does not exist.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer accepts this cursor. Restart pagination from the first page.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer serves this data. Retrying fails the same way.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request rate limit was exceeded.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"451":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The owner of this profile asked Openhandle not to serve it.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request failed internally.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The service is temporarily unavailable.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}}},"security":[{"OpenhandleKey":[]}],"summary":"List profile stories","tags":["Instagram","Entity"],"x-openhandle-operation":"instagram.profile.stories.list","x-openhandle-sdk":{"operation":"list","paginated":true,"path":"instagram.profile.stories.list","scope":[{"name":"instagram"},{"name":"profile","parameter":"identifier","reference":"profile"},{"name":"stories"}]},"x-openhandle-test-data":{"catalogUrl":"/v1/test-data?operation=instagram.profile.stories.list","contentHash":"sha256:7794275e0d6f248bb315a82bf631385a86ae70d2957dd815951fce7615602735","datasetVersion":"2026-10-27.2","example":{"comment":"synthetic comment","identifier":"@northstar_forge_test","media_id":"910100000001","query":"synthetic"}}}},"/v1/instagram/profiles/{identifier}/suggested":{"get":{"description":"Return a cursor-paginated collection of Instagram profiles. Test and Live use the same route, parameters, response schema, pagination, and errors. In Test, null means unavailable, not zero.","operationId":"instagramProfileSuggestedList","parameters":[{"description":"Public resource reference. Profile paths accept a username with an @ prefix, such as @openai, or the stable platform ID. Post paths accept the platform post ID or shortcode.","example":"@northstar_forge_test","in":"path","name":"identifier","required":true,"schema":{"minLength":1,"type":"string"}},{"description":"Maximum accepted data age. The default is 24h.","example":"24h","in":"query","name":"freshness","required":false,"schema":{"default":"24h","enum":["live","24h","7d","30d"],"type":"string"}},{"description":"Opaque cursor returned by the previous page.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/SuccessEnvelope"},{"properties":{"data":{"items":{"$ref":"#/components/schemas/InstagramProfile"},"type":"array"}},"required":["data","meta"],"type":"object"}]}}},"description":"A successful Test or Live response.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The locator, cursor, or query is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The API key is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Live billing does not permit this request.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource is private or workspace API access is security-suspended.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource does not exist.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer accepts this cursor. Restart pagination from the first page.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer serves this data. Retrying fails the same way.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request rate limit was exceeded.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"451":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The owner of this profile asked Openhandle not to serve it.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request failed internally.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The service is temporarily unavailable.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}}},"security":[{"OpenhandleKey":[]}],"summary":"List profile suggested","tags":["Instagram","Profile"],"x-openhandle-operation":"instagram.profile.suggested.list","x-openhandle-sdk":{"operation":"list","paginated":true,"path":"instagram.profile.suggested.list","scope":[{"name":"instagram"},{"name":"profile","parameter":"identifier","reference":"profile"},{"name":"suggested"}]},"x-openhandle-test-data":{"catalogUrl":"/v1/test-data?operation=instagram.profile.suggested.list","contentHash":"sha256:7794275e0d6f248bb315a82bf631385a86ae70d2957dd815951fce7615602735","datasetVersion":"2026-10-27.2","example":{"identifier":"@northstar_forge_test"}}}},"/v1/instagram/profiles/{identifier}/tagged-posts":{"get":{"description":"Return a cursor-paginated collection of a public Instagram profile's tagged posts. Test and Live use the same route, parameters, response schema, pagination, and errors. In Test, null means unavailable, not zero.","operationId":"instagramProfileTagged_postsList","parameters":[{"description":"Public resource reference. Profile paths accept a username with an @ prefix, such as @openai, or the stable platform ID. Post paths accept the platform post ID or shortcode.","example":"@northstar_forge_test","in":"path","name":"identifier","required":true,"schema":{"minLength":1,"type":"string"}},{"description":"Maximum accepted data age. The default is 24h.","example":"24h","in":"query","name":"freshness","required":false,"schema":{"default":"24h","enum":["live","24h","7d","30d"],"type":"string"}},{"description":"Opaque cursor returned by the previous page.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/SuccessEnvelope"},{"properties":{"data":{"items":{"$ref":"#/components/schemas/InstagramPost"},"type":"array"}},"required":["data","meta"],"type":"object"}]}}},"description":"A successful Test or Live response.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The locator, cursor, or query is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The API key is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Live billing does not permit this request.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource is private or workspace API access is security-suspended.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource does not exist.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer accepts this cursor. Restart pagination from the first page.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer serves this data. Retrying fails the same way.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request rate limit was exceeded.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"451":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The owner of this profile asked Openhandle not to serve it.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request failed internally.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The service is temporarily unavailable.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}}},"security":[{"OpenhandleKey":[]}],"summary":"List profile tagged posts","tags":["Instagram","Post"],"x-openhandle-operation":"instagram.profile.tagged.posts.list","x-openhandle-sdk":{"operation":"list","paginated":true,"path":"instagram.profile.taggedPosts.list","scope":[{"name":"instagram"},{"name":"profile","parameter":"identifier","reference":"profile"},{"name":"taggedPosts"}]},"x-openhandle-test-data":{"catalogUrl":"/v1/test-data?operation=instagram.profile.tagged.posts.list","contentHash":"sha256:7794275e0d6f248bb315a82bf631385a86ae70d2957dd815951fce7615602735","datasetVersion":"2026-10-27.2","example":{"identifier":"@northstar_forge_test"}}}},"/v1/instagram/profiles/{identifier}/videos":{"get":{"description":"Return a cursor-paginated collection of a public Instagram profile's videos. Test and Live use the same route, parameters, response schema, pagination, and errors. In Test, null means unavailable, not zero.","operationId":"instagramProfileVideosList","parameters":[{"description":"Public resource reference. Profile paths accept a username with an @ prefix, such as @openai, or the stable platform ID. Post paths accept the platform post ID or shortcode.","example":"@northstar_forge_test","in":"path","name":"identifier","required":true,"schema":{"minLength":1,"type":"string"}},{"description":"Maximum accepted data age. The default is 24h.","example":"24h","in":"query","name":"freshness","required":false,"schema":{"default":"24h","enum":["live","24h","7d","30d"],"type":"string"}},{"description":"Opaque cursor returned by the previous page.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/SuccessEnvelope"},{"properties":{"data":{"items":{"$ref":"#/components/schemas/InstagramPost"},"type":"array"}},"required":["data","meta"],"type":"object"}]}}},"description":"A successful Test or Live response.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The locator, cursor, or query is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The API key is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Live billing does not permit this request.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource is private or workspace API access is security-suspended.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource does not exist.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer accepts this cursor. Restart pagination from the first page.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer serves this data. Retrying fails the same way.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request rate limit was exceeded.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"451":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The owner of this profile asked Openhandle not to serve it.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request failed internally.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The service is temporarily unavailable.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}}},"security":[{"OpenhandleKey":[]}],"summary":"List profile videos","tags":["Instagram","Post"],"x-openhandle-operation":"instagram.profile.videos.list","x-openhandle-sdk":{"operation":"list","paginated":true,"path":"instagram.profile.videos.list","scope":[{"name":"instagram"},{"name":"profile","parameter":"identifier","reference":"profile"},{"name":"videos"}]},"x-openhandle-test-data":{"catalogUrl":"/v1/test-data?operation=instagram.profile.videos.list","contentHash":"sha256:7794275e0d6f248bb315a82bf631385a86ae70d2957dd815951fce7615602735","datasetVersion":"2026-10-27.2","example":{"identifier":"@northstar_forge_test"}}}},"/v1/instagram/search/hashtags":{"get":{"description":"Search public Instagram hashtags with cursor pagination. Test and Live use the same route, parameters, response schema, pagination, and errors. In Test, null means unavailable, not zero.","operationId":"instagramSearchHashtags","parameters":[{"description":"Public search query.","example":"synthetic","in":"query","name":"q","required":true,"schema":{"minLength":1,"type":"string"}},{"description":"Maximum accepted data age. The default is 24h.","example":"24h","in":"query","name":"freshness","required":false,"schema":{"default":"24h","enum":["live","24h","7d","30d"],"type":"string"}},{"description":"Opaque cursor returned by the previous page.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/SuccessEnvelope"},{"properties":{"data":{"items":{"$ref":"#/components/schemas/InstagramHashtag"},"type":"array"}},"required":["data","meta"],"type":"object"}]}}},"description":"A successful Test or Live response.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The locator, cursor, or query is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The API key is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Live billing does not permit this request.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource is private or workspace API access is security-suspended.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource does not exist.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer accepts this cursor. Restart pagination from the first page.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer serves this data. Retrying fails the same way.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request rate limit was exceeded.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"451":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The owner of this profile asked Openhandle not to serve it.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request failed internally.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The service is temporarily unavailable.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}}},"security":[{"OpenhandleKey":[]}],"summary":"Search Instagram hashtags","tags":["Instagram","Hashtag"],"x-openhandle-operation":"instagram.search.hashtags.list","x-openhandle-sdk":{"operation":"list","paginated":true,"path":"instagram.search.hashtags.list","scope":[{"name":"instagram"},{"name":"search"},{"name":"hashtags"}]},"x-openhandle-test-data":{"catalogUrl":"/v1/test-data?operation=instagram.search.hashtags.list","contentHash":"sha256:7794275e0d6f248bb315a82bf631385a86ae70d2957dd815951fce7615602735","datasetVersion":"2026-10-27.2","example":{"query":"synthetic"}}}},"/v1/instagram/search/music":{"get":{"description":"Search public Instagram music with cursor pagination. Test and Live use the same route, parameters, response schema, pagination, and errors. In Test, null means unavailable, not zero.","operationId":"instagramSearchMusic","parameters":[{"description":"Public search query.","example":"synthetic","in":"query","name":"q","required":true,"schema":{"minLength":1,"type":"string"}},{"description":"Maximum accepted data age. The default is 24h.","example":"24h","in":"query","name":"freshness","required":false,"schema":{"default":"24h","enum":["live","24h","7d","30d"],"type":"string"}},{"description":"Opaque cursor returned by the previous page.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/SuccessEnvelope"},{"properties":{"data":{"items":{"$ref":"#/components/schemas/InstagramMusic"},"type":"array"}},"required":["data","meta"],"type":"object"}]}}},"description":"A successful Test or Live response.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The locator, cursor, or query is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The API key is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Live billing does not permit this request.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource is private or workspace API access is security-suspended.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource does not exist.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer accepts this cursor. Restart pagination from the first page.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer serves this data. Retrying fails the same way.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request rate limit was exceeded.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"451":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The owner of this profile asked Openhandle not to serve it.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request failed internally.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The service is temporarily unavailable.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}}},"security":[{"OpenhandleKey":[]}],"summary":"Search Instagram music","tags":["Instagram","Music"],"x-openhandle-operation":"instagram.search.music.list","x-openhandle-sdk":{"operation":"list","paginated":true,"path":"instagram.search.music.list","scope":[{"name":"instagram"},{"name":"search"},{"name":"music"}]},"x-openhandle-test-data":{"catalogUrl":"/v1/test-data?operation=instagram.search.music.list","contentHash":"sha256:7794275e0d6f248bb315a82bf631385a86ae70d2957dd815951fce7615602735","datasetVersion":"2026-10-27.2","example":{"query":"synthetic"}}}},"/v1/instagram/search/places":{"get":{"description":"Search public Instagram places with cursor pagination. Test and Live use the same route, parameters, response schema, pagination, and errors. In Test, null means unavailable, not zero.","operationId":"instagramSearchPlaces","parameters":[{"description":"Public search query.","example":"synthetic","in":"query","name":"q","required":true,"schema":{"minLength":1,"type":"string"}},{"description":"Maximum accepted data age. The default is 24h.","example":"24h","in":"query","name":"freshness","required":false,"schema":{"default":"24h","enum":["live","24h","7d","30d"],"type":"string"}},{"description":"Opaque cursor returned by the previous page.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/SuccessEnvelope"},{"properties":{"data":{"items":{"$ref":"#/components/schemas/InstagramLocation"},"type":"array"}},"required":["data","meta"],"type":"object"}]}}},"description":"A successful Test or Live response.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The locator, cursor, or query is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The API key is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Live billing does not permit this request.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource is private or workspace API access is security-suspended.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource does not exist.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer accepts this cursor. Restart pagination from the first page.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer serves this data. Retrying fails the same way.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request rate limit was exceeded.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"451":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The owner of this profile asked Openhandle not to serve it.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request failed internally.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The service is temporarily unavailable.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}}},"security":[{"OpenhandleKey":[]}],"summary":"Search Instagram places","tags":["Instagram","Location"],"x-openhandle-operation":"instagram.search.places.list","x-openhandle-sdk":{"operation":"list","paginated":true,"path":"instagram.search.places.list","scope":[{"name":"instagram"},{"name":"search"},{"name":"places"}]},"x-openhandle-test-data":{"catalogUrl":"/v1/test-data?operation=instagram.search.places.list","contentHash":"sha256:7794275e0d6f248bb315a82bf631385a86ae70d2957dd815951fce7615602735","datasetVersion":"2026-10-27.2","example":{"query":"synthetic"}}}},"/v1/instagram/search/profiles":{"get":{"description":"Search public Instagram profiles with cursor pagination. Test and Live use the same route, parameters, response schema, pagination, and errors. In Test, null means unavailable, not zero.","operationId":"instagramSearchProfiles","parameters":[{"description":"Public search query.","example":"synthetic","in":"query","name":"q","required":true,"schema":{"minLength":1,"type":"string"}},{"description":"Maximum accepted data age. The default is 24h.","example":"24h","in":"query","name":"freshness","required":false,"schema":{"default":"24h","enum":["live","24h","7d","30d"],"type":"string"}},{"description":"Opaque cursor returned by the previous page.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/SuccessEnvelope"},{"properties":{"data":{"items":{"$ref":"#/components/schemas/InstagramProfile"},"type":"array"}},"required":["data","meta"],"type":"object"}]}}},"description":"A successful Test or Live response.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The locator, cursor, or query is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The API key is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Live billing does not permit this request.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource is private or workspace API access is security-suspended.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource does not exist.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer accepts this cursor. Restart pagination from the first page.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer serves this data. Retrying fails the same way.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request rate limit was exceeded.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"451":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The owner of this profile asked Openhandle not to serve it.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request failed internally.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The service is temporarily unavailable.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}}},"security":[{"OpenhandleKey":[]}],"summary":"Search Instagram profiles","tags":["Instagram","Profile"],"x-openhandle-operation":"instagram.search.profiles.list","x-openhandle-sdk":{"operation":"list","paginated":true,"path":"instagram.search.profiles.list","scope":[{"name":"instagram"},{"name":"search"},{"name":"profiles"}]},"x-openhandle-test-data":{"catalogUrl":"/v1/test-data?operation=instagram.search.profiles.list","contentHash":"sha256:7794275e0d6f248bb315a82bf631385a86ae70d2957dd815951fce7615602735","datasetVersion":"2026-10-27.2","example":{"query":"synthetic"}}}},"/v1/instagram/search/reels":{"get":{"description":"Search public Instagram reels with cursor pagination. Test and Live use the same route, parameters, response schema, pagination, and errors. In Test, null means unavailable, not zero.","operationId":"instagramSearchReels","parameters":[{"description":"Public search query.","example":"synthetic","in":"query","name":"q","required":true,"schema":{"minLength":1,"type":"string"}},{"description":"Maximum accepted data age. The default is 24h.","example":"24h","in":"query","name":"freshness","required":false,"schema":{"default":"24h","enum":["live","24h","7d","30d"],"type":"string"}},{"description":"Opaque cursor returned by the previous page.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/SuccessEnvelope"},{"properties":{"data":{"items":{"$ref":"#/components/schemas/InstagramPost"},"type":"array"}},"required":["data","meta"],"type":"object"}]}}},"description":"A successful Test or Live response.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The locator, cursor, or query is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The API key is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Live billing does not permit this request.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource is private or workspace API access is security-suspended.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource does not exist.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer accepts this cursor. Restart pagination from the first page.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer serves this data. Retrying fails the same way.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request rate limit was exceeded.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"451":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The owner of this profile asked Openhandle not to serve it.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request failed internally.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The service is temporarily unavailable.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}}},"security":[{"OpenhandleKey":[]}],"summary":"Search Instagram reels","tags":["Instagram","Post"],"x-openhandle-operation":"instagram.search.reels.list","x-openhandle-sdk":{"operation":"list","paginated":true,"path":"instagram.search.reels.list","scope":[{"name":"instagram"},{"name":"search"},{"name":"reels"}]},"x-openhandle-test-data":{"catalogUrl":"/v1/test-data?operation=instagram.search.reels.list","contentHash":"sha256:7794275e0d6f248bb315a82bf631385a86ae70d2957dd815951fce7615602735","datasetVersion":"2026-10-27.2","example":{"query":"synthetic"}}}},"/v1/instagram/search/top":{"get":{"description":"Search all Instagram results from public Instagram data. Test and Live use the same route, parameters, response schema, pagination, and errors. In Test, null means unavailable, not zero.","operationId":"Instagram_search_top_list","parameters":[{"description":"Public search query.","example":"synthetic","in":"query","name":"q","required":true,"schema":{"minLength":1,"type":"string"}},{"description":"Maximum accepted data age. The default is 24h.","example":"24h","in":"query","name":"freshness","required":false,"schema":{"default":"24h","enum":["live","24h","7d","30d"],"type":"string"}},{"description":"Opaque cursor returned by the previous page.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/SuccessEnvelope"},{"properties":{"data":{"items":{"$ref":"#/components/schemas/InstagramSearchResult"},"type":"array"}},"required":["data","meta"],"type":"object"}]}}},"description":"A successful Test or Live response.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The locator, cursor, or query is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The API key is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Live billing does not permit this request.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource is private or workspace API access is security-suspended.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource does not exist.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer accepts this cursor. Restart pagination from the first page.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer serves this data. Retrying fails the same way.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request rate limit was exceeded.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"451":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The owner of this profile asked Openhandle not to serve it.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request failed internally.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The service is temporarily unavailable.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}}},"security":[{"OpenhandleKey":[]}],"summary":"Search all Instagram results","tags":["Instagram","Entity"],"x-openhandle-operation":"instagram.search.top.list","x-openhandle-sdk":{"operation":"list","paginated":true,"path":"instagram.search.top.list","scope":[{"name":"instagram"},{"name":"search"},{"name":"top"}]},"x-openhandle-test-data":{"catalogUrl":"/v1/test-data?operation=instagram.search.top.list","contentHash":"sha256:7794275e0d6f248bb315a82bf631385a86ae70d2957dd815951fce7615602735","datasetVersion":"2026-10-27.2","example":{"comment":"synthetic comment","media_id":"910100000001","query":"synthetic"}}}},"/v1/instagram/stories/{identifier}":{"get":{"description":"Get a story from public Instagram data. Test and Live use the same route, parameters, response schema, pagination, and errors. In Test, null means unavailable, not zero.","operationId":"Instagram_story_get","parameters":[{"description":"Public resource reference. Profile paths accept a username with an @ prefix, such as @openai, or the stable platform ID. Post paths accept the platform post ID or shortcode.","example":"910100000001","in":"path","name":"identifier","required":true,"schema":{"minLength":1,"type":"string"}},{"description":"Maximum accepted data age. The default is 24h.","example":"24h","in":"query","name":"freshness","required":false,"schema":{"default":"24h","enum":["live","24h","7d","30d"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/SuccessEnvelope"},{"properties":{"data":{"$ref":"#/components/schemas/InstagramStory"}},"required":["data"],"type":"object"}]}}},"description":"A successful Test or Live response.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The locator, cursor, or query is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The API key is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Live billing does not permit this request.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource is private or workspace API access is security-suspended.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource does not exist.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer serves this data. Retrying fails the same way.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request rate limit was exceeded.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"451":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The owner of this profile asked Openhandle not to serve it.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request failed internally.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The service is temporarily unavailable.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}}},"security":[{"OpenhandleKey":[]}],"summary":"Get a story","tags":["Instagram","Entity"],"x-openhandle-operation":"instagram.story.get","x-openhandle-sdk":{"operation":"get","paginated":false,"path":"instagram.story.get","scope":[{"name":"instagram"},{"name":"story","parameter":"identifier","reference":"story"}]},"x-openhandle-test-data":{"catalogUrl":"/v1/test-data?operation=instagram.story.get","contentHash":"sha256:7794275e0d6f248bb315a82bf631385a86ae70d2957dd815951fce7615602735","datasetVersion":"2026-10-27.2","example":{"comment":"synthetic comment","identifier":"910100000001","media_id":"910100000001","query":"synthetic"}}}},"/v1/reddit/domains/{identifier}/posts":{"get":{"description":"List domain posts from public Reddit data. Test and Live use the same route, parameters, response schema, pagination, and errors. In Test, null means unavailable, not zero.","operationId":"Reddit_domain_posts_list","parameters":[{"description":"Public resource reference. Profile paths accept a username with an @ prefix, such as @openai, or the stable platform ID. Post paths accept the platform post ID or shortcode.","example":"example.com","in":"path","name":"identifier","required":true,"schema":{"minLength":1,"type":"string"}},{"description":"Result ordering for this operation.","example":"hot","in":"query","name":"sort","required":false,"schema":{"default":"hot","enum":["hot","new","top","rising","controversial"],"type":"string"}},{"description":"Time window for top and controversial results.","example":"week","in":"query","name":"t","required":false,"schema":{"enum":["hour","day","week","month","year","all"],"type":"string"}},{"description":"Maximum number of results to return.","example":"25","in":"query","name":"limit","required":false,"schema":{"default":25,"maximum":100,"minimum":1,"type":"integer"}},{"description":"Maximum accepted data age. The default is 24h.","example":"24h","in":"query","name":"freshness","required":false,"schema":{"default":"24h","enum":["live","24h","7d","30d"],"type":"string"}},{"description":"Opaque cursor returned by the previous page.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/SuccessEnvelope"},{"properties":{"data":{"items":{"$ref":"#/components/schemas/RedditPost"},"type":"array"}},"required":["data","meta"],"type":"object"}]}}},"description":"A successful Test or Live response.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The locator, cursor, or query is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The API key is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Live billing does not permit this request.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource is private or workspace API access is security-suspended.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource does not exist.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer accepts this cursor. Restart pagination from the first page.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer serves this data. Retrying fails the same way.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request rate limit was exceeded.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"451":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The owner of this profile asked Openhandle not to serve it.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request failed internally.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The service is temporarily unavailable.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}}},"security":[{"OpenhandleKey":[]}],"summary":"List domain posts","tags":["Reddit","Post"],"x-openhandle-operation":"reddit.domain.posts.list","x-openhandle-sdk":{"operation":"list","paginated":true,"path":"reddit.domain.posts.list","scope":[{"name":"reddit"},{"name":"domain","parameter":"identifier","reference":"domain"},{"name":"posts"}]},"x-openhandle-test-data":{"catalogUrl":"/v1/test-data?operation=reddit.domain.posts.list","contentHash":"sha256:7794275e0d6f248bb315a82bf631385a86ae70d2957dd815951fce7615602735","datasetVersion":"2026-10-27.2","example":{"identifier":"example.com","page":"index","query":"synthetic"}}}},"/v1/reddit/posts/{identifier}":{"get":{"description":"Get a post from public Reddit data. Test and Live use the same route, parameters, response schema, pagination, and errors. In Test, null means unavailable, not zero.","operationId":"Reddit_post_get","parameters":[{"description":"Public resource reference. Profile paths accept a username with an @ prefix, such as @openai, or the stable platform ID. Post paths accept the platform post ID or shortcode.","example":"synthetic","in":"path","name":"identifier","required":true,"schema":{"minLength":1,"type":"string"}},{"description":"Maximum accepted data age. The default is 24h.","example":"24h","in":"query","name":"freshness","required":false,"schema":{"default":"24h","enum":["live","24h","7d","30d"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/SuccessEnvelope"},{"properties":{"data":{"$ref":"#/components/schemas/RedditPost"}},"required":["data"],"type":"object"}]}}},"description":"A successful Test or Live response.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The locator, cursor, or query is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The API key is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Live billing does not permit this request.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource is private or workspace API access is security-suspended.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource does not exist.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer serves this data. Retrying fails the same way.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request rate limit was exceeded.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"451":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The owner of this profile asked Openhandle not to serve it.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request failed internally.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The service is temporarily unavailable.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}}},"security":[{"OpenhandleKey":[]}],"summary":"Get a post","tags":["Reddit","Post"],"x-openhandle-operation":"reddit.post.get","x-openhandle-sdk":{"operation":"get","paginated":false,"path":"reddit.post.get","scope":[{"name":"reddit"},{"name":"post","parameter":"identifier","reference":"post"}]},"x-openhandle-test-data":{"catalogUrl":"/v1/test-data?operation=reddit.post.get","contentHash":"sha256:7794275e0d6f248bb315a82bf631385a86ae70d2957dd815951fce7615602735","datasetVersion":"2026-10-27.2","example":{"identifier":"synthetic","page":"index","query":"synthetic"}}}},"/v1/reddit/posts/{identifier}/comments":{"get":{"description":"List post comments from public Reddit data. Test and Live use the same route, parameters, response schema, pagination, and errors. In Test, null means unavailable, not zero.","operationId":"Reddit_post_comments_list","parameters":[{"description":"Public resource reference. Profile paths accept a username with an @ prefix, such as @openai, or the stable platform ID. Post paths accept the platform post ID or shortcode.","example":"synthetic","in":"path","name":"identifier","required":true,"schema":{"minLength":1,"type":"string"}},{"description":"Result ordering for this operation.","example":"confidence","in":"query","name":"sort","required":false,"schema":{"default":"confidence","enum":["confidence","top","new","controversial","old","qa"],"type":"string"}},{"description":"Maximum number of results to return.","example":"25","in":"query","name":"limit","required":false,"schema":{"default":25,"maximum":100,"minimum":1,"type":"integer"}},{"description":"Maximum depth of nested replies.","example":"2","in":"query","name":"depth","required":false,"schema":{"maximum":10,"minimum":0,"type":"integer"}},{"description":"Maximum accepted data age. The default is 24h.","example":"24h","in":"query","name":"freshness","required":false,"schema":{"default":"24h","enum":["live","24h","7d","30d"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/SuccessEnvelope"},{"properties":{"data":{"items":{"$ref":"#/components/schemas/RedditComment"},"type":"array"}},"required":["data"],"type":"object"}]}}},"description":"A successful Test or Live response.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The locator, cursor, or query is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The API key is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Live billing does not permit this request.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource is private or workspace API access is security-suspended.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource does not exist.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer serves this data. Retrying fails the same way.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request rate limit was exceeded.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"451":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The owner of this profile asked Openhandle not to serve it.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request failed internally.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The service is temporarily unavailable.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}}},"security":[{"OpenhandleKey":[]}],"summary":"List post comments","tags":["Reddit","Comment"],"x-openhandle-operation":"reddit.post.comments.list","x-openhandle-sdk":{"operation":"list","paginated":false,"path":"reddit.post.comments.list","scope":[{"name":"reddit"},{"name":"post","parameter":"identifier","reference":"post"},{"name":"comments"}]},"x-openhandle-test-data":{"catalogUrl":"/v1/test-data?operation=reddit.post.comments.list","contentHash":"sha256:7794275e0d6f248bb315a82bf631385a86ae70d2957dd815951fce7615602735","datasetVersion":"2026-10-27.2","example":{"identifier":"synthetic","page":"index","query":"synthetic"}}}},"/v1/reddit/posts/{identifier}/duplicates":{"get":{"description":"List duplicate posts from public Reddit data. Test and Live use the same route, parameters, response schema, pagination, and errors. In Test, null means unavailable, not zero.","operationId":"Reddit_post_duplicates_list","parameters":[{"description":"Public resource reference. Profile paths accept a username with an @ prefix, such as @openai, or the stable platform ID. Post paths accept the platform post ID or shortcode.","example":"synthetic","in":"path","name":"identifier","required":true,"schema":{"minLength":1,"type":"string"}},{"description":"Maximum number of results to return.","example":"25","in":"query","name":"limit","required":false,"schema":{"default":25,"maximum":100,"minimum":1,"type":"integer"}},{"description":"Maximum accepted data age. The default is 24h.","example":"24h","in":"query","name":"freshness","required":false,"schema":{"default":"24h","enum":["live","24h","7d","30d"],"type":"string"}},{"description":"Opaque cursor returned by the previous page.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/SuccessEnvelope"},{"properties":{"data":{"items":{"$ref":"#/components/schemas/RedditPost"},"type":"array"}},"required":["data","meta"],"type":"object"}]}}},"description":"A successful Test or Live response.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The locator, cursor, or query is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The API key is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Live billing does not permit this request.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource is private or workspace API access is security-suspended.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource does not exist.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer accepts this cursor. Restart pagination from the first page.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer serves this data. Retrying fails the same way.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request rate limit was exceeded.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"451":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The owner of this profile asked Openhandle not to serve it.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request failed internally.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The service is temporarily unavailable.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}}},"security":[{"OpenhandleKey":[]}],"summary":"List duplicate posts","tags":["Reddit","Post"],"x-openhandle-operation":"reddit.post.duplicates.list","x-openhandle-sdk":{"operation":"list","paginated":true,"path":"reddit.post.duplicates.list","scope":[{"name":"reddit"},{"name":"post","parameter":"identifier","reference":"post"},{"name":"duplicates"}]},"x-openhandle-test-data":{"catalogUrl":"/v1/test-data?operation=reddit.post.duplicates.list","contentHash":"sha256:7794275e0d6f248bb315a82bf631385a86ae70d2957dd815951fce7615602735","datasetVersion":"2026-10-27.2","example":{"identifier":"synthetic","page":"index","query":"synthetic"}}}},"/v1/reddit/profiles/{identifier}":{"get":{"description":"Return one public Reddit profile. Use @username or a t2_ profile ID. An ID resolves only after the profile was read by username once. Test and Live use the same route, parameters, response schema, pagination, and errors. In Test, null means unavailable, not zero.","operationId":"Reddit_profile_get","parameters":[{"description":"Public resource reference. Profile paths accept a username with an @ prefix, such as @openai, or the stable platform ID. Post paths accept the platform post ID or shortcode.","example":"@synthetic_reddit","in":"path","name":"identifier","required":true,"schema":{"minLength":1,"type":"string"}},{"description":"Maximum accepted data age. The default is 24h.","example":"24h","in":"query","name":"freshness","required":false,"schema":{"default":"24h","enum":["live","24h","7d","30d"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/SuccessEnvelope"},{"properties":{"data":{"$ref":"#/components/schemas/RedditProfile"}},"required":["data"],"type":"object"}]}}},"description":"A successful Test or Live response.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The locator, cursor, or query is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The API key is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Live billing does not permit this request.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource is private or workspace API access is security-suspended.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource does not exist.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer serves this data. Retrying fails the same way.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request rate limit was exceeded.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"451":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The owner of this profile asked Openhandle not to serve it.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request failed internally.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The service is temporarily unavailable.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}}},"security":[{"OpenhandleKey":[]}],"summary":"Get a profile","tags":["Reddit","Profile"],"x-openhandle-operation":"reddit.profile.get","x-openhandle-sdk":{"operation":"get","paginated":false,"path":"reddit.profile.get","scope":[{"name":"reddit"},{"name":"profile","parameter":"identifier","reference":"profile"}]},"x-openhandle-test-data":{"catalogUrl":"/v1/test-data?operation=reddit.profile.get","contentHash":"sha256:7794275e0d6f248bb315a82bf631385a86ae70d2957dd815951fce7615602735","datasetVersion":"2026-10-27.2","example":{"identifier":"@synthetic_reddit"}}}},"/v1/reddit/profiles/{identifier}/comments":{"get":{"description":"List profile comments from public Reddit data. Test and Live use the same route, parameters, response schema, pagination, and errors. In Test, null means unavailable, not zero.","operationId":"Reddit_profile_comments_list","parameters":[{"description":"Public resource reference. Profile paths accept a username with an @ prefix, such as @openai, or the stable platform ID. Post paths accept the platform post ID or shortcode.","example":"@synthetic_reddit","in":"path","name":"identifier","required":true,"schema":{"minLength":1,"type":"string"}},{"description":"Result ordering for this operation.","example":"new","in":"query","name":"sort","required":false,"schema":{"default":"new","enum":["new","hot","top","controversial"],"type":"string"}},{"description":"Time window for top and controversial results.","example":"week","in":"query","name":"t","required":false,"schema":{"enum":["hour","day","week","month","year","all"],"type":"string"}},{"description":"Maximum number of results to return.","example":"25","in":"query","name":"limit","required":false,"schema":{"default":25,"maximum":100,"minimum":1,"type":"integer"}},{"description":"Maximum accepted data age. The default is 24h.","example":"24h","in":"query","name":"freshness","required":false,"schema":{"default":"24h","enum":["live","24h","7d","30d"],"type":"string"}},{"description":"Opaque cursor returned by the previous page.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/SuccessEnvelope"},{"properties":{"data":{"items":{"$ref":"#/components/schemas/RedditComment"},"type":"array"}},"required":["data","meta"],"type":"object"}]}}},"description":"A successful Test or Live response.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The locator, cursor, or query is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The API key is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Live billing does not permit this request.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource is private or workspace API access is security-suspended.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource does not exist.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer accepts this cursor. Restart pagination from the first page.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer serves this data. Retrying fails the same way.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request rate limit was exceeded.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"451":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The owner of this profile asked Openhandle not to serve it.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request failed internally.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The service is temporarily unavailable.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}}},"security":[{"OpenhandleKey":[]}],"summary":"List profile comments","tags":["Reddit","Comment"],"x-openhandle-operation":"reddit.profile.comments.list","x-openhandle-sdk":{"operation":"list","paginated":true,"path":"reddit.profile.comments.list","scope":[{"name":"reddit"},{"name":"profile","parameter":"identifier","reference":"profile"},{"name":"comments"}]},"x-openhandle-test-data":{"catalogUrl":"/v1/test-data?operation=reddit.profile.comments.list","contentHash":"sha256:7794275e0d6f248bb315a82bf631385a86ae70d2957dd815951fce7615602735","datasetVersion":"2026-10-27.2","example":{"identifier":"@synthetic_reddit","page":"index","query":"synthetic"}}}},"/v1/reddit/profiles/{identifier}/moderated":{"get":{"description":"List moderated subreddits from public Reddit data. Test and Live use the same route, parameters, response schema, pagination, and errors. In Test, null means unavailable, not zero.","operationId":"Reddit_profile_moderated_list","parameters":[{"description":"Public resource reference. Profile paths accept a username with an @ prefix, such as @openai, or the stable platform ID. Post paths accept the platform post ID or shortcode.","example":"@synthetic_reddit","in":"path","name":"identifier","required":true,"schema":{"minLength":1,"type":"string"}},{"description":"Maximum accepted data age. The default is 24h.","example":"24h","in":"query","name":"freshness","required":false,"schema":{"default":"24h","enum":["live","24h","7d","30d"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/SuccessEnvelope"},{"properties":{"data":{"items":{"$ref":"#/components/schemas/RedditSubreddit"},"type":"array"}},"required":["data"],"type":"object"}]}}},"description":"A successful Test or Live response.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The locator, cursor, or query is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The API key is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Live billing does not permit this request.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource is private or workspace API access is security-suspended.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource does not exist.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer serves this data. Retrying fails the same way.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request rate limit was exceeded.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"451":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The owner of this profile asked Openhandle not to serve it.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request failed internally.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The service is temporarily unavailable.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}}},"security":[{"OpenhandleKey":[]}],"summary":"List moderated subreddits","tags":["Reddit","Subreddit"],"x-openhandle-operation":"reddit.profile.moderated.list","x-openhandle-sdk":{"operation":"list","paginated":false,"path":"reddit.profile.moderated.list","scope":[{"name":"reddit"},{"name":"profile","parameter":"identifier","reference":"profile"},{"name":"moderated"}]},"x-openhandle-test-data":{"catalogUrl":"/v1/test-data?operation=reddit.profile.moderated.list","contentHash":"sha256:7794275e0d6f248bb315a82bf631385a86ae70d2957dd815951fce7615602735","datasetVersion":"2026-10-27.2","example":{"identifier":"@synthetic_reddit","page":"index","query":"synthetic"}}}},"/v1/reddit/profiles/{identifier}/posts":{"get":{"description":"List profile posts from public Reddit data. Test and Live use the same route, parameters, response schema, pagination, and errors. In Test, null means unavailable, not zero.","operationId":"Reddit_profile_posts_list","parameters":[{"description":"Public resource reference. Profile paths accept a username with an @ prefix, such as @openai, or the stable platform ID. Post paths accept the platform post ID or shortcode.","example":"@synthetic_reddit","in":"path","name":"identifier","required":true,"schema":{"minLength":1,"type":"string"}},{"description":"Result ordering for this operation.","example":"new","in":"query","name":"sort","required":false,"schema":{"default":"new","enum":["new","hot","top","controversial"],"type":"string"}},{"description":"Time window for top and controversial results.","example":"week","in":"query","name":"t","required":false,"schema":{"enum":["hour","day","week","month","year","all"],"type":"string"}},{"description":"Maximum number of results to return.","example":"25","in":"query","name":"limit","required":false,"schema":{"default":25,"maximum":100,"minimum":1,"type":"integer"}},{"description":"Maximum accepted data age. The default is 24h.","example":"24h","in":"query","name":"freshness","required":false,"schema":{"default":"24h","enum":["live","24h","7d","30d"],"type":"string"}},{"description":"Opaque cursor returned by the previous page.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/SuccessEnvelope"},{"properties":{"data":{"items":{"$ref":"#/components/schemas/RedditPost"},"type":"array"}},"required":["data","meta"],"type":"object"}]}}},"description":"A successful Test or Live response.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The locator, cursor, or query is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The API key is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Live billing does not permit this request.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource is private or workspace API access is security-suspended.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource does not exist.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer accepts this cursor. Restart pagination from the first page.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer serves this data. Retrying fails the same way.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request rate limit was exceeded.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"451":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The owner of this profile asked Openhandle not to serve it.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request failed internally.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The service is temporarily unavailable.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}}},"security":[{"OpenhandleKey":[]}],"summary":"List profile posts","tags":["Reddit","Post"],"x-openhandle-operation":"reddit.profile.posts.list","x-openhandle-sdk":{"operation":"list","paginated":true,"path":"reddit.profile.posts.list","scope":[{"name":"reddit"},{"name":"profile","parameter":"identifier","reference":"profile"},{"name":"posts"}]},"x-openhandle-test-data":{"catalogUrl":"/v1/test-data?operation=reddit.profile.posts.list","contentHash":"sha256:7794275e0d6f248bb315a82bf631385a86ae70d2957dd815951fce7615602735","datasetVersion":"2026-10-27.2","example":{"identifier":"@synthetic_reddit","page":"index","query":"synthetic"}}}},"/v1/reddit/profiles/{identifier}/trophies":{"get":{"description":"List profile trophies from public Reddit data. Test and Live use the same route, parameters, response schema, pagination, and errors. In Test, null means unavailable, not zero.","operationId":"Reddit_profile_trophies_list","parameters":[{"description":"Public resource reference. Profile paths accept a username with an @ prefix, such as @openai, or the stable platform ID. Post paths accept the platform post ID or shortcode.","example":"@synthetic_reddit","in":"path","name":"identifier","required":true,"schema":{"minLength":1,"type":"string"}},{"description":"Maximum accepted data age. The default is 24h.","example":"24h","in":"query","name":"freshness","required":false,"schema":{"default":"24h","enum":["live","24h","7d","30d"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/SuccessEnvelope"},{"properties":{"data":{"items":{"$ref":"#/components/schemas/RedditTrophy"},"type":"array"}},"required":["data"],"type":"object"}]}}},"description":"A successful Test or Live response.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The locator, cursor, or query is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The API key is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Live billing does not permit this request.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource is private or workspace API access is security-suspended.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource does not exist.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer serves this data. Retrying fails the same way.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request rate limit was exceeded.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"451":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The owner of this profile asked Openhandle not to serve it.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request failed internally.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The service is temporarily unavailable.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}}},"security":[{"OpenhandleKey":[]}],"summary":"List profile trophies","tags":["Reddit","Trophy"],"x-openhandle-operation":"reddit.profile.trophies.list","x-openhandle-sdk":{"operation":"list","paginated":false,"path":"reddit.profile.trophies.list","scope":[{"name":"reddit"},{"name":"profile","parameter":"identifier","reference":"profile"},{"name":"trophies"}]},"x-openhandle-test-data":{"catalogUrl":"/v1/test-data?operation=reddit.profile.trophies.list","contentHash":"sha256:7794275e0d6f248bb315a82bf631385a86ae70d2957dd815951fce7615602735","datasetVersion":"2026-10-27.2","example":{"identifier":"@synthetic_reddit","page":"index","query":"synthetic"}}}},"/v1/reddit/search/posts":{"get":{"description":"Search posts from public Reddit data. Test and Live use the same route, parameters, response schema, pagination, and errors. In Test, null means unavailable, not zero.","operationId":"Reddit_search_posts_list","parameters":[{"description":"Public search query.","example":"synthetic","in":"query","name":"q","required":true,"schema":{"minLength":1,"type":"string"}},{"description":"Result ordering for this operation.","example":"relevance","in":"query","name":"sort","required":false,"schema":{"default":"relevance","enum":["relevance","hot","top","new","comments"],"type":"string"}},{"description":"Search inside one subreddit only.","in":"query","name":"subreddit","required":false,"schema":{"minLength":1,"type":"string"}},{"description":"Time window for top and controversial results.","example":"week","in":"query","name":"t","required":false,"schema":{"enum":["hour","day","week","month","year","all"],"type":"string"}},{"description":"Maximum number of results to return.","example":"25","in":"query","name":"limit","required":false,"schema":{"default":25,"maximum":100,"minimum":1,"type":"integer"}},{"description":"Maximum accepted data age. The default is 24h.","example":"24h","in":"query","name":"freshness","required":false,"schema":{"default":"24h","enum":["live","24h","7d","30d"],"type":"string"}},{"description":"Opaque cursor returned by the previous page.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/SuccessEnvelope"},{"properties":{"data":{"items":{"$ref":"#/components/schemas/RedditPost"},"type":"array"}},"required":["data","meta"],"type":"object"}]}}},"description":"A successful Test or Live response.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The locator, cursor, or query is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The API key is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Live billing does not permit this request.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource is private or workspace API access is security-suspended.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource does not exist.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer accepts this cursor. Restart pagination from the first page.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer serves this data. Retrying fails the same way.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request rate limit was exceeded.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"451":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The owner of this profile asked Openhandle not to serve it.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request failed internally.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The service is temporarily unavailable.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}}},"security":[{"OpenhandleKey":[]}],"summary":"Search posts","tags":["Reddit","Post"],"x-openhandle-operation":"reddit.search.posts.list","x-openhandle-sdk":{"operation":"list","paginated":true,"path":"reddit.search.posts.list","scope":[{"name":"reddit"},{"name":"search"},{"name":"posts"}]},"x-openhandle-test-data":{"catalogUrl":"/v1/test-data?operation=reddit.search.posts.list","contentHash":"sha256:7794275e0d6f248bb315a82bf631385a86ae70d2957dd815951fce7615602735","datasetVersion":"2026-10-27.2","example":{"page":"index","query":"synthetic"}}}},"/v1/reddit/search/profiles":{"get":{"description":"Search profiles from public Reddit data. Test and Live use the same route, parameters, response schema, pagination, and errors. In Test, null means unavailable, not zero.","operationId":"Reddit_search_profiles_list","parameters":[{"description":"Public search query.","example":"synthetic","in":"query","name":"q","required":true,"schema":{"minLength":1,"type":"string"}},{"description":"Maximum number of results to return.","example":"25","in":"query","name":"limit","required":false,"schema":{"default":25,"maximum":100,"minimum":1,"type":"integer"}},{"description":"Maximum accepted data age. The default is 24h.","example":"24h","in":"query","name":"freshness","required":false,"schema":{"default":"24h","enum":["live","24h","7d","30d"],"type":"string"}},{"description":"Opaque cursor returned by the previous page.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/SuccessEnvelope"},{"properties":{"data":{"items":{"$ref":"#/components/schemas/RedditProfile"},"type":"array"}},"required":["data","meta"],"type":"object"}]}}},"description":"A successful Test or Live response.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The locator, cursor, or query is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The API key is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Live billing does not permit this request.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource is private or workspace API access is security-suspended.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource does not exist.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer accepts this cursor. Restart pagination from the first page.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer serves this data. Retrying fails the same way.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request rate limit was exceeded.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"451":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The owner of this profile asked Openhandle not to serve it.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request failed internally.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The service is temporarily unavailable.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}}},"security":[{"OpenhandleKey":[]}],"summary":"Search profiles","tags":["Reddit","Profile"],"x-openhandle-operation":"reddit.search.profiles.list","x-openhandle-sdk":{"operation":"list","paginated":true,"path":"reddit.search.profiles.list","scope":[{"name":"reddit"},{"name":"search"},{"name":"profiles"}]},"x-openhandle-test-data":{"catalogUrl":"/v1/test-data?operation=reddit.search.profiles.list","contentHash":"sha256:7794275e0d6f248bb315a82bf631385a86ae70d2957dd815951fce7615602735","datasetVersion":"2026-10-27.2","example":{"page":"index","query":"synthetic"}}}},"/v1/reddit/search/subreddits":{"get":{"description":"Search subreddits from public Reddit data. Test and Live use the same route, parameters, response schema, pagination, and errors. In Test, null means unavailable, not zero.","operationId":"Reddit_search_subreddits_list","parameters":[{"description":"Public search query.","example":"synthetic","in":"query","name":"q","required":true,"schema":{"minLength":1,"type":"string"}},{"description":"Maximum number of results to return.","example":"25","in":"query","name":"limit","required":false,"schema":{"default":25,"maximum":100,"minimum":1,"type":"integer"}},{"description":"Maximum accepted data age. The default is 24h.","example":"24h","in":"query","name":"freshness","required":false,"schema":{"default":"24h","enum":["live","24h","7d","30d"],"type":"string"}},{"description":"Opaque cursor returned by the previous page.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/SuccessEnvelope"},{"properties":{"data":{"items":{"$ref":"#/components/schemas/RedditSubreddit"},"type":"array"}},"required":["data","meta"],"type":"object"}]}}},"description":"A successful Test or Live response.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The locator, cursor, or query is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The API key is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Live billing does not permit this request.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource is private or workspace API access is security-suspended.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource does not exist.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer accepts this cursor. Restart pagination from the first page.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer serves this data. Retrying fails the same way.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request rate limit was exceeded.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"451":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The owner of this profile asked Openhandle not to serve it.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request failed internally.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The service is temporarily unavailable.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}}},"security":[{"OpenhandleKey":[]}],"summary":"Search subreddits","tags":["Reddit","Subreddit"],"x-openhandle-operation":"reddit.search.subreddits.list","x-openhandle-sdk":{"operation":"list","paginated":true,"path":"reddit.search.subreddits.list","scope":[{"name":"reddit"},{"name":"search"},{"name":"subreddits"}]},"x-openhandle-test-data":{"catalogUrl":"/v1/test-data?operation=reddit.search.subreddits.list","contentHash":"sha256:7794275e0d6f248bb315a82bf631385a86ae70d2957dd815951fce7615602735","datasetVersion":"2026-10-27.2","example":{"page":"index","query":"synthetic"}}}},"/v1/reddit/subreddits/new":{"get":{"description":"List new subreddits from public Reddit data. Test and Live use the same route, parameters, response schema, pagination, and errors. In Test, null means unavailable, not zero.","operationId":"Reddit_subreddits_new_list","parameters":[{"description":"Maximum number of results to return.","example":"25","in":"query","name":"limit","required":false,"schema":{"default":25,"maximum":100,"minimum":1,"type":"integer"}},{"description":"Maximum accepted data age. The default is 24h.","example":"24h","in":"query","name":"freshness","required":false,"schema":{"default":"24h","enum":["live","24h","7d","30d"],"type":"string"}},{"description":"Opaque cursor returned by the previous page.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/SuccessEnvelope"},{"properties":{"data":{"items":{"$ref":"#/components/schemas/RedditSubreddit"},"type":"array"}},"required":["data","meta"],"type":"object"}]}}},"description":"A successful Test or Live response.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The locator, cursor, or query is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The API key is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Live billing does not permit this request.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource is private or workspace API access is security-suspended.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource does not exist.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer accepts this cursor. Restart pagination from the first page.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer serves this data. Retrying fails the same way.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request rate limit was exceeded.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"451":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The owner of this profile asked Openhandle not to serve it.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request failed internally.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The service is temporarily unavailable.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}}},"security":[{"OpenhandleKey":[]}],"summary":"List new subreddits","tags":["Reddit","Subreddit"],"x-openhandle-operation":"reddit.subreddits.new.list","x-openhandle-sdk":{"operation":"list","paginated":true,"path":"reddit.subreddits.new.list","scope":[{"name":"reddit"},{"name":"subreddits"},{"name":"new"}]},"x-openhandle-test-data":{"catalogUrl":"/v1/test-data?operation=reddit.subreddits.new.list","contentHash":"sha256:7794275e0d6f248bb315a82bf631385a86ae70d2957dd815951fce7615602735","datasetVersion":"2026-10-27.2","example":{"handle":"synthetic_reddit","id":"synthetic","page":"index","q":"synthetic","query":"synthetic"}}}},"/v1/reddit/subreddits/popular":{"get":{"description":"List popular subreddits from public Reddit data. Test and Live use the same route, parameters, response schema, pagination, and errors. In Test, null means unavailable, not zero.","operationId":"Reddit_subreddits_popular_list","parameters":[{"description":"Maximum number of results to return.","example":"25","in":"query","name":"limit","required":false,"schema":{"default":25,"maximum":100,"minimum":1,"type":"integer"}},{"description":"Maximum accepted data age. The default is 24h.","example":"24h","in":"query","name":"freshness","required":false,"schema":{"default":"24h","enum":["live","24h","7d","30d"],"type":"string"}},{"description":"Opaque cursor returned by the previous page.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/SuccessEnvelope"},{"properties":{"data":{"items":{"$ref":"#/components/schemas/RedditSubreddit"},"type":"array"}},"required":["data","meta"],"type":"object"}]}}},"description":"A successful Test or Live response.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The locator, cursor, or query is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The API key is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Live billing does not permit this request.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource is private or workspace API access is security-suspended.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource does not exist.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer accepts this cursor. Restart pagination from the first page.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer serves this data. Retrying fails the same way.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request rate limit was exceeded.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"451":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The owner of this profile asked Openhandle not to serve it.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request failed internally.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The service is temporarily unavailable.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}}},"security":[{"OpenhandleKey":[]}],"summary":"List popular subreddits","tags":["Reddit","Subreddit"],"x-openhandle-operation":"reddit.subreddits.popular.list","x-openhandle-sdk":{"operation":"list","paginated":true,"path":"reddit.subreddits.popular.list","scope":[{"name":"reddit"},{"name":"subreddits"},{"name":"popular"}]},"x-openhandle-test-data":{"catalogUrl":"/v1/test-data?operation=reddit.subreddits.popular.list","contentHash":"sha256:7794275e0d6f248bb315a82bf631385a86ae70d2957dd815951fce7615602735","datasetVersion":"2026-10-27.2","example":{"handle":"synthetic_reddit","id":"synthetic","page":"index","q":"synthetic","query":"synthetic"}}}},"/v1/reddit/subreddits/{identifier}":{"get":{"description":"Get a subreddit from public Reddit data. Test and Live use the same route, parameters, response schema, pagination, and errors. In Test, null means unavailable, not zero.","operationId":"Reddit_subreddit_get","parameters":[{"description":"Public resource reference. Profile paths accept a username with an @ prefix, such as @openai, or the stable platform ID. Post paths accept the platform post ID or shortcode.","example":"synthetic","in":"path","name":"identifier","required":true,"schema":{"minLength":1,"type":"string"}},{"description":"Maximum accepted data age. The default is 24h.","example":"24h","in":"query","name":"freshness","required":false,"schema":{"default":"24h","enum":["live","24h","7d","30d"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/SuccessEnvelope"},{"properties":{"data":{"$ref":"#/components/schemas/RedditSubreddit"}},"required":["data"],"type":"object"}]}}},"description":"A successful Test or Live response.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The locator, cursor, or query is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The API key is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Live billing does not permit this request.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource is private or workspace API access is security-suspended.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource does not exist.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer serves this data. Retrying fails the same way.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request rate limit was exceeded.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"451":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The owner of this profile asked Openhandle not to serve it.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request failed internally.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The service is temporarily unavailable.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}}},"security":[{"OpenhandleKey":[]}],"summary":"Get a subreddit","tags":["Reddit","Subreddit"],"x-openhandle-operation":"reddit.subreddit.get","x-openhandle-sdk":{"operation":"get","paginated":false,"path":"reddit.subreddit.get","scope":[{"name":"reddit"},{"name":"subreddit","parameter":"identifier","reference":"subreddit"}]},"x-openhandle-test-data":{"catalogUrl":"/v1/test-data?operation=reddit.subreddit.get","contentHash":"sha256:7794275e0d6f248bb315a82bf631385a86ae70d2957dd815951fce7615602735","datasetVersion":"2026-10-27.2","example":{"identifier":"synthetic","page":"index","query":"synthetic"}}}},"/v1/reddit/subreddits/{identifier}/posts":{"get":{"description":"List subreddit posts from public Reddit data. Test and Live use the same route, parameters, response schema, pagination, and errors. In Test, null means unavailable, not zero.","operationId":"Reddit_subreddit_posts_list","parameters":[{"description":"Public resource reference. Profile paths accept a username with an @ prefix, such as @openai, or the stable platform ID. Post paths accept the platform post ID or shortcode.","example":"synthetic","in":"path","name":"identifier","required":true,"schema":{"minLength":1,"type":"string"}},{"description":"Result ordering for this operation.","example":"hot","in":"query","name":"sort","required":false,"schema":{"default":"hot","enum":["hot","new","top","rising","controversial"],"type":"string"}},{"description":"Time window for top and controversial results.","example":"week","in":"query","name":"t","required":false,"schema":{"enum":["hour","day","week","month","year","all"],"type":"string"}},{"description":"Maximum number of results to return.","example":"25","in":"query","name":"limit","required":false,"schema":{"default":25,"maximum":100,"minimum":1,"type":"integer"}},{"description":"Maximum accepted data age. The default is 24h.","example":"24h","in":"query","name":"freshness","required":false,"schema":{"default":"24h","enum":["live","24h","7d","30d"],"type":"string"}},{"description":"Opaque cursor returned by the previous page.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/SuccessEnvelope"},{"properties":{"data":{"items":{"$ref":"#/components/schemas/RedditPost"},"type":"array"}},"required":["data","meta"],"type":"object"}]}}},"description":"A successful Test or Live response.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The locator, cursor, or query is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The API key is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Live billing does not permit this request.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource is private or workspace API access is security-suspended.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource does not exist.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer accepts this cursor. Restart pagination from the first page.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer serves this data. Retrying fails the same way.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request rate limit was exceeded.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"451":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The owner of this profile asked Openhandle not to serve it.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request failed internally.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The service is temporarily unavailable.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}}},"security":[{"OpenhandleKey":[]}],"summary":"List subreddit posts","tags":["Reddit","Post"],"x-openhandle-operation":"reddit.subreddit.posts.list","x-openhandle-sdk":{"operation":"list","paginated":true,"path":"reddit.subreddit.posts.list","scope":[{"name":"reddit"},{"name":"subreddit","parameter":"identifier","reference":"subreddit"},{"name":"posts"}]},"x-openhandle-test-data":{"catalogUrl":"/v1/test-data?operation=reddit.subreddit.posts.list","contentHash":"sha256:7794275e0d6f248bb315a82bf631385a86ae70d2957dd815951fce7615602735","datasetVersion":"2026-10-27.2","example":{"identifier":"synthetic","page":"index","query":"synthetic"}}}},"/v1/reddit/subreddits/{identifier}/rules":{"get":{"description":"List subreddit rules from public Reddit data. Test and Live use the same route, parameters, response schema, pagination, and errors. In Test, null means unavailable, not zero.","operationId":"Reddit_subreddit_rules_list","parameters":[{"description":"Public resource reference. Profile paths accept a username with an @ prefix, such as @openai, or the stable platform ID. Post paths accept the platform post ID or shortcode.","example":"synthetic","in":"path","name":"identifier","required":true,"schema":{"minLength":1,"type":"string"}},{"description":"Maximum accepted data age. The default is 24h.","example":"24h","in":"query","name":"freshness","required":false,"schema":{"default":"24h","enum":["live","24h","7d","30d"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/SuccessEnvelope"},{"properties":{"data":{"items":{"$ref":"#/components/schemas/RedditRule"},"type":"array"}},"required":["data"],"type":"object"}]}}},"description":"A successful Test or Live response.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The locator, cursor, or query is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The API key is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Live billing does not permit this request.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource is private or workspace API access is security-suspended.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource does not exist.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer serves this data. Retrying fails the same way.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request rate limit was exceeded.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"451":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The owner of this profile asked Openhandle not to serve it.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request failed internally.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The service is temporarily unavailable.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}}},"security":[{"OpenhandleKey":[]}],"summary":"List subreddit rules","tags":["Reddit","Rule"],"x-openhandle-operation":"reddit.subreddit.rules.list","x-openhandle-sdk":{"operation":"list","paginated":false,"path":"reddit.subreddit.rules.list","scope":[{"name":"reddit"},{"name":"subreddit","parameter":"identifier","reference":"subreddit"},{"name":"rules"}]},"x-openhandle-test-data":{"catalogUrl":"/v1/test-data?operation=reddit.subreddit.rules.list","contentHash":"sha256:7794275e0d6f248bb315a82bf631385a86ae70d2957dd815951fce7615602735","datasetVersion":"2026-10-27.2","example":{"identifier":"synthetic","page":"index","query":"synthetic"}}}},"/v1/reddit/subreddits/{identifier}/wiki-pages":{"get":{"description":"List wiki pages from public Reddit data. Test and Live use the same route, parameters, response schema, pagination, and errors. In Test, null means unavailable, not zero.","operationId":"Reddit_subreddit_wiki_list","parameters":[{"description":"Public resource reference. Profile paths accept a username with an @ prefix, such as @openai, or the stable platform ID. Post paths accept the platform post ID or shortcode.","example":"synthetic","in":"path","name":"identifier","required":true,"schema":{"minLength":1,"type":"string"}},{"description":"Maximum accepted data age. The default is 24h.","example":"24h","in":"query","name":"freshness","required":false,"schema":{"default":"24h","enum":["live","24h","7d","30d"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/SuccessEnvelope"},{"properties":{"data":{"items":{"$ref":"#/components/schemas/RedditWikiPage"},"type":"array"}},"required":["data"],"type":"object"}]}}},"description":"A successful Test or Live response.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The locator, cursor, or query is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The API key is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Live billing does not permit this request.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource is private or workspace API access is security-suspended.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource does not exist.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer serves this data. Retrying fails the same way.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request rate limit was exceeded.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"451":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The owner of this profile asked Openhandle not to serve it.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request failed internally.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The service is temporarily unavailable.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}}},"security":[{"OpenhandleKey":[]}],"summary":"List wiki pages","tags":["Reddit","Wiki"],"x-openhandle-operation":"reddit.subreddit.wiki.list","x-openhandle-sdk":{"operation":"list","paginated":false,"path":"reddit.subreddit.wikiPages.list","scope":[{"name":"reddit"},{"name":"subreddit","parameter":"identifier","reference":"subreddit"},{"name":"wikiPages"}]},"x-openhandle-test-data":{"catalogUrl":"/v1/test-data?operation=reddit.subreddit.wiki.list","contentHash":"sha256:7794275e0d6f248bb315a82bf631385a86ae70d2957dd815951fce7615602735","datasetVersion":"2026-10-27.2","example":{"identifier":"synthetic","page":"index","query":"synthetic"}}}},"/v1/reddit/subreddits/{identifier}/wiki-pages/{page}":{"get":{"description":"Get a wiki page from public Reddit data. Test and Live use the same route, parameters, response schema, pagination, and errors. In Test, null means unavailable, not zero.","operationId":"Reddit_subreddit_wiki_page_get","parameters":[{"description":"Public resource reference. Profile paths accept a username with an @ prefix, such as @openai, or the stable platform ID. Post paths accept the platform post ID or shortcode.","example":"synthetic","in":"path","name":"identifier","required":true,"schema":{"minLength":1,"type":"string"}},{"description":"Wiki page name.","example":"index","in":"path","name":"page","required":true,"schema":{"minLength":1,"type":"string"}},{"description":"Maximum accepted data age. The default is 24h.","example":"24h","in":"query","name":"freshness","required":false,"schema":{"default":"24h","enum":["live","24h","7d","30d"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/SuccessEnvelope"},{"properties":{"data":{"$ref":"#/components/schemas/RedditWikiPage"}},"required":["data"],"type":"object"}]}}},"description":"A successful Test or Live response.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The locator, cursor, or query is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The API key is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Live billing does not permit this request.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource is private or workspace API access is security-suspended.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource does not exist.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer serves this data. Retrying fails the same way.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request rate limit was exceeded.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"451":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The owner of this profile asked Openhandle not to serve it.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request failed internally.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The service is temporarily unavailable.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}}},"security":[{"OpenhandleKey":[]}],"summary":"Get a wiki page","tags":["Reddit","Wiki"],"x-openhandle-operation":"reddit.subreddit.wiki.page.get","x-openhandle-sdk":{"operation":"get","paginated":false,"path":"reddit.subreddit.wikiPage.get","scope":[{"name":"reddit"},{"name":"subreddit","parameter":"identifier","reference":"subreddit"},{"name":"wikiPage","parameter":"page","reference":"wikiPage"}]},"x-openhandle-test-data":{"catalogUrl":"/v1/test-data?operation=reddit.subreddit.wiki.page.get","contentHash":"sha256:7794275e0d6f248bb315a82bf631385a86ae70d2957dd815951fce7615602735","datasetVersion":"2026-10-27.2","example":{"identifier":"synthetic","page":"index","query":"synthetic"}}}},"/v1/reddit/trending/posts":{"get":{"description":"List trending posts from public Reddit data. Test and Live use the same route, parameters, response schema, pagination, and errors. In Test, null means unavailable, not zero.","operationId":"Reddit_trending_posts_list","parameters":[{"description":"Result ordering for this operation.","example":"hot","in":"query","name":"sort","required":false,"schema":{"default":"hot","enum":["hot","new","top","rising","controversial","best"],"type":"string"}},{"description":"Time window for top and controversial results.","example":"week","in":"query","name":"t","required":false,"schema":{"enum":["hour","day","week","month","year","all"],"type":"string"}},{"description":"Maximum number of results to return.","example":"25","in":"query","name":"limit","required":false,"schema":{"default":25,"maximum":100,"minimum":1,"type":"integer"}},{"description":"Maximum accepted data age. The default is 24h.","example":"24h","in":"query","name":"freshness","required":false,"schema":{"default":"24h","enum":["live","24h","7d","30d"],"type":"string"}},{"description":"Opaque cursor returned by the previous page.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/SuccessEnvelope"},{"properties":{"data":{"items":{"$ref":"#/components/schemas/RedditPost"},"type":"array"}},"required":["data","meta"],"type":"object"}]}}},"description":"A successful Test or Live response.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The locator, cursor, or query is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The API key is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Live billing does not permit this request.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource is private or workspace API access is security-suspended.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource does not exist.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer accepts this cursor. Restart pagination from the first page.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer serves this data. Retrying fails the same way.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request rate limit was exceeded.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"451":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The owner of this profile asked Openhandle not to serve it.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request failed internally.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The service is temporarily unavailable.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}}},"security":[{"OpenhandleKey":[]}],"summary":"List trending posts","tags":["Reddit","Post"],"x-openhandle-operation":"reddit.trending.posts.list","x-openhandle-sdk":{"operation":"list","paginated":true,"path":"reddit.trending.posts.list","scope":[{"name":"reddit"},{"name":"trending"},{"name":"posts"}]},"x-openhandle-test-data":{"catalogUrl":"/v1/test-data?operation=reddit.trending.posts.list","contentHash":"sha256:7794275e0d6f248bb315a82bf631385a86ae70d2957dd815951fce7615602735","datasetVersion":"2026-10-27.2","example":{"handle":"synthetic_reddit","id":"synthetic","page":"index","q":"synthetic","query":"synthetic"}}}},"/v1/test-data":{"get":{"description":"Public, unmetered discovery. Filter by platform, resource, operation, traits, expected status, error code, or text.","operationId":"listTestData","parameters":[{"description":"Provider-specific public-data filter for this operation.","in":"query","name":"platform","required":false,"schema":{"enum":["instagram","tiktok","twitter","reddit","youtube"],"type":"string"}},{"description":"Provider-specific public-data filter for this operation.","in":"query","name":"resource","required":false,"schema":{"enum":["profile","post","comment","hashtag","location","music","category","list","entity","subreddit","rule","wiki","trophy","playlist","transcript","product","chart","files","storyboard","frame"],"type":"string"}},{"description":"Provider-specific public-data filter for this operation.","in":"query","name":"operation","required":false,"schema":{"type":"string"}},{"description":"Provider-specific public-data filter for this operation.","in":"query","name":"traits","required":false,"schema":{"type":"string"}},{"description":"Provider-specific public-data filter for this operation.","in":"query","name":"status","required":false,"schema":{"type":"integer"}},{"description":"Provider-specific public-data filter for this operation.","in":"query","name":"errorCode","required":false,"schema":{"type":"string"}},{"description":"Provider-specific public-data filter for this operation.","in":"query","name":"search","required":false,"schema":{"type":"string"}},{"description":"Maximum number of results to return.","example":"100","in":"query","name":"limit","required":false,"schema":{"default":100,"maximum":100,"minimum":1,"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TestDataCatalogEnvelope"}}},"description":"Matching catalog entries for the active dataset version."}},"summary":"Search the synthetic test-data catalog","x-openhandle-sdk":{"operation":"list","paginated":false,"path":"testData.list","scope":[{"name":"testData"}]}}},"/v1/test-data/{id}":{"get":{"operationId":"getTestData","parameters":[{"description":"Provider-specific public-data filter for this operation.","example":"instagram.profile.northstar-forge","in":"path","name":"id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TestDataEntryEnvelope"}}},"description":"The catalog entry."},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MessageEnvelope"}}},"description":"The catalog entry does not exist."}},"summary":"Get one synthetic catalog entry","x-openhandle-sdk":{"operation":"get","paginated":false,"path":"testData.entry.get","scope":[{"name":"testData"},{"name":"entry","parameter":"id","reference":"testDataEntry"}]}}},"/v1/tiktok/effects":{"get":{"description":"Get effects in a batch from public Tiktok data. Test and Live use the same route, parameters, response schema, pagination, and errors. In Test, null means unavailable, not zero.","operationId":"Tiktok_effects_list","parameters":[{"description":"Comma-separated opaque native IDs.","example":"950000000007","in":"query","name":"ids","required":true,"schema":{"minLength":1,"type":"string"}},{"description":"Maximum accepted data age. The default is 24h.","example":"24h","in":"query","name":"freshness","required":false,"schema":{"default":"24h","enum":["live","24h","7d","30d"],"type":"string"}},{"description":"Opaque cursor returned by the previous page.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/SuccessEnvelope"},{"properties":{"data":{"items":{"$ref":"#/components/schemas/TikTokEffect"},"type":"array"}},"required":["data","meta"],"type":"object"}]}}},"description":"A successful Test or Live response.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The locator, cursor, or query is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The API key is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Live billing does not permit this request.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource is private or workspace API access is security-suspended.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource does not exist.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer accepts this cursor. Restart pagination from the first page.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer serves this data. Retrying fails the same way.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request rate limit was exceeded.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"451":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The owner of this profile asked Openhandle not to serve it.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request failed internally.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The service is temporarily unavailable.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}}},"security":[{"OpenhandleKey":[]}],"summary":"Get effects in a batch","tags":["Tiktok","Entity"],"x-openhandle-operation":"tiktok.effects.list","x-openhandle-sdk":{"operation":"list","paginated":true,"path":"tiktok.effects.list","scope":[{"name":"tiktok"},{"name":"effects"}]},"x-openhandle-test-data":{"catalogUrl":"/v1/test-data?operation=tiktok.effects.list","contentHash":"sha256:7794275e0d6f248bb315a82bf631385a86ae70d2957dd815951fce7615602735","datasetVersion":"2026-10-27.2","example":{"category_id":"950000000008","comment":"synthetic","comment_id":"920200000000000001","ids":"950000000007","playlist_id":"950000000006","post_id":"920100000000000001","product_source_type":"0","query":"synthetic","rank_type":"daily","room_id":"950000000009","user_id":"920000000001"}}}},"/v1/tiktok/effects/{identifier}":{"get":{"description":"Get an effect from public Tiktok data. Test and Live use the same route, parameters, response schema, pagination, and errors. In Test, null means unavailable, not zero.","operationId":"Tiktok_effect_get","parameters":[{"description":"Public resource reference. Profile paths accept a username with an @ prefix, such as @openai, or the stable platform ID. Post paths accept the platform post ID or shortcode.","example":"920100000000000001","in":"path","name":"identifier","required":true,"schema":{"minLength":1,"type":"string"}},{"description":"Maximum accepted data age. The default is 24h.","example":"24h","in":"query","name":"freshness","required":false,"schema":{"default":"24h","enum":["live","24h","7d","30d"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/SuccessEnvelope"},{"properties":{"data":{"$ref":"#/components/schemas/TikTokEffect"}},"required":["data"],"type":"object"}]}}},"description":"A successful Test or Live response.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The locator, cursor, or query is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The API key is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Live billing does not permit this request.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource is private or workspace API access is security-suspended.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource does not exist.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer serves this data. Retrying fails the same way.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request rate limit was exceeded.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"451":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The owner of this profile asked Openhandle not to serve it.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request failed internally.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The service is temporarily unavailable.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}}},"security":[{"OpenhandleKey":[]}],"summary":"Get an effect","tags":["Tiktok","Entity"],"x-openhandle-operation":"tiktok.effect.get","x-openhandle-sdk":{"operation":"get","paginated":false,"path":"tiktok.effect.get","scope":[{"name":"tiktok"},{"name":"effect","parameter":"identifier","reference":"effect"}]},"x-openhandle-test-data":{"catalogUrl":"/v1/test-data?operation=tiktok.effect.get","contentHash":"sha256:7794275e0d6f248bb315a82bf631385a86ae70d2957dd815951fce7615602735","datasetVersion":"2026-10-27.2","example":{"category_id":"950000000008","comment":"synthetic","comment_id":"920200000000000001","identifier":"920100000000000001","ids":"950000000007","playlist_id":"950000000006","post_id":"920100000000000001","product_source_type":"0","query":"synthetic","rank_type":"daily","room_id":"950000000009","user_id":"920000000001"}}}},"/v1/tiktok/effects/{identifier}/posts":{"get":{"description":"Return a cursor-paginated collection of TikTok posts that use an effect. Test and Live use the same route, parameters, response schema, pagination, and errors. In Test, null means unavailable, not zero.","operationId":"tiktokEffectPostsList","parameters":[{"description":"Public resource reference. Profile paths accept a username with an @ prefix, such as @openai, or the stable platform ID. Post paths accept the platform post ID or shortcode.","example":"920100000000000001","in":"path","name":"identifier","required":true,"schema":{"minLength":1,"type":"string"}},{"description":"Maximum accepted data age. The default is 24h.","example":"24h","in":"query","name":"freshness","required":false,"schema":{"default":"24h","enum":["live","24h","7d","30d"],"type":"string"}},{"description":"Opaque cursor returned by the previous page.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/SuccessEnvelope"},{"properties":{"data":{"items":{"$ref":"#/components/schemas/TikTokPost"},"type":"array"}},"required":["data","meta"],"type":"object"}]}}},"description":"A successful Test or Live response.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The locator, cursor, or query is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The API key is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Live billing does not permit this request.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource is private or workspace API access is security-suspended.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource does not exist.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer accepts this cursor. Restart pagination from the first page.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer serves this data. Retrying fails the same way.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request rate limit was exceeded.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"451":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The owner of this profile asked Openhandle not to serve it.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request failed internally.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The service is temporarily unavailable.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}}},"security":[{"OpenhandleKey":[]}],"summary":"List effect posts","tags":["Tiktok","Post"],"x-openhandle-operation":"tiktok.effect.posts.list","x-openhandle-sdk":{"operation":"list","paginated":true,"path":"tiktok.effect.posts.list","scope":[{"name":"tiktok"},{"name":"effect","parameter":"identifier","reference":"effect"},{"name":"posts"}]},"x-openhandle-test-data":{"catalogUrl":"/v1/test-data?operation=tiktok.effect.posts.list","contentHash":"sha256:7794275e0d6f248bb315a82bf631385a86ae70d2957dd815951fce7615602735","datasetVersion":"2026-10-27.2","example":{"identifier":"920100000000000001"}}}},"/v1/tiktok/hashtags/{identifier}":{"get":{"description":"Return one public hashtag by its native identifier. Test and Live use the same route, parameters, response schema, pagination, and errors. In Test, null means unavailable, not zero.","operationId":"tiktokHashtagGet","parameters":[{"description":"Public resource reference. Profile paths accept a username with an @ prefix, such as @openai, or the stable platform ID. Post paths accept the platform post ID or shortcode.","example":"950000000001","in":"path","name":"identifier","required":true,"schema":{"minLength":1,"type":"string"}},{"description":"Maximum accepted data age. The default is 24h.","example":"24h","in":"query","name":"freshness","required":false,"schema":{"default":"24h","enum":["live","24h","7d","30d"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/SuccessEnvelope"},{"properties":{"data":{"$ref":"#/components/schemas/TikTokHashtag"}},"required":["data"],"type":"object"}]}}},"description":"A successful Test or Live response.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The locator, cursor, or query is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The API key is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Live billing does not permit this request.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource is private or workspace API access is security-suspended.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource does not exist.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer serves this data. Retrying fails the same way.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request rate limit was exceeded.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"451":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The owner of this profile asked Openhandle not to serve it.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request failed internally.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The service is temporarily unavailable.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}}},"security":[{"OpenhandleKey":[]}],"summary":"Get a hashtag","tags":["Tiktok","Hashtag"],"x-openhandle-operation":"tiktok.hashtag.get","x-openhandle-sdk":{"operation":"get","paginated":false,"path":"tiktok.hashtag.get","scope":[{"name":"tiktok"},{"name":"hashtag","parameter":"identifier","reference":"hashtag"}]},"x-openhandle-test-data":{"catalogUrl":"/v1/test-data?operation=tiktok.hashtag.get","contentHash":"sha256:7794275e0d6f248bb315a82bf631385a86ae70d2957dd815951fce7615602735","datasetVersion":"2026-10-27.2","example":{"identifier":"950000000001","query":"synthetic"}}}},"/v1/tiktok/hashtags/{identifier}/posts":{"get":{"description":"Return a cursor-paginated collection of public posts. Test and Live use the same route, parameters, response schema, pagination, and errors. In Test, null means unavailable, not zero.","operationId":"tiktokHashtagPostsList","parameters":[{"description":"Public resource reference. Profile paths accept a username with an @ prefix, such as @openai, or the stable platform ID. Post paths accept the platform post ID or shortcode.","example":"950000000001","in":"path","name":"identifier","required":true,"schema":{"minLength":1,"type":"string"}},{"description":"Maximum accepted data age. The default is 24h.","example":"24h","in":"query","name":"freshness","required":false,"schema":{"default":"24h","enum":["live","24h","7d","30d"],"type":"string"}},{"description":"Opaque cursor returned by the previous page.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/SuccessEnvelope"},{"properties":{"data":{"items":{"$ref":"#/components/schemas/TikTokPost"},"type":"array"}},"required":["data","meta"],"type":"object"}]}}},"description":"A successful Test or Live response.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The locator, cursor, or query is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The API key is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Live billing does not permit this request.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource is private or workspace API access is security-suspended.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource does not exist.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer accepts this cursor. Restart pagination from the first page.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer serves this data. Retrying fails the same way.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request rate limit was exceeded.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"451":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The owner of this profile asked Openhandle not to serve it.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request failed internally.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The service is temporarily unavailable.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}}},"security":[{"OpenhandleKey":[]}],"summary":"List hashtag posts","tags":["Tiktok","Post"],"x-openhandle-operation":"tiktok.hashtag.posts.list","x-openhandle-sdk":{"operation":"list","paginated":true,"path":"tiktok.hashtag.posts.list","scope":[{"name":"tiktok"},{"name":"hashtag","parameter":"identifier","reference":"hashtag"},{"name":"posts"}]},"x-openhandle-test-data":{"catalogUrl":"/v1/test-data?operation=tiktok.hashtag.posts.list","contentHash":"sha256:7794275e0d6f248bb315a82bf631385a86ae70d2957dd815951fce7615602735","datasetVersion":"2026-10-27.2","example":{"identifier":"950000000001","query":"synthetic"}}}},"/v1/tiktok/locations/{identifier}":{"get":{"description":"Return one public location by its native identifier. Test and Live use the same route, parameters, response schema, pagination, and errors. In Test, null means unavailable, not zero.","operationId":"tiktokLocationGet","parameters":[{"description":"Public resource reference. Profile paths accept a username with an @ prefix, such as @openai, or the stable platform ID. Post paths accept the platform post ID or shortcode.","example":"950000000002","in":"path","name":"identifier","required":true,"schema":{"minLength":1,"type":"string"}},{"description":"Maximum accepted data age. The default is 24h.","example":"24h","in":"query","name":"freshness","required":false,"schema":{"default":"24h","enum":["live","24h","7d","30d"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/SuccessEnvelope"},{"properties":{"data":{"$ref":"#/components/schemas/TikTokLocation"}},"required":["data"],"type":"object"}]}}},"description":"A successful Test or Live response.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The locator, cursor, or query is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The API key is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Live billing does not permit this request.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource is private or workspace API access is security-suspended.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource does not exist.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer serves this data. Retrying fails the same way.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request rate limit was exceeded.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"451":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The owner of this profile asked Openhandle not to serve it.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request failed internally.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The service is temporarily unavailable.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}}},"security":[{"OpenhandleKey":[]}],"summary":"Get a location","tags":["Tiktok","Location"],"x-openhandle-operation":"tiktok.location.get","x-openhandle-sdk":{"operation":"get","paginated":false,"path":"tiktok.location.get","scope":[{"name":"tiktok"},{"name":"location","parameter":"identifier","reference":"location"}]},"x-openhandle-test-data":{"catalogUrl":"/v1/test-data?operation=tiktok.location.get","contentHash":"sha256:7794275e0d6f248bb315a82bf631385a86ae70d2957dd815951fce7615602735","datasetVersion":"2026-10-27.2","example":{"identifier":"950000000002","query":"synthetic"}}}},"/v1/tiktok/locations/{identifier}/posts":{"get":{"description":"Return a cursor-paginated collection of public posts. Test and Live use the same route, parameters, response schema, pagination, and errors. In Test, null means unavailable, not zero.","operationId":"tiktokLocationPostsList","parameters":[{"description":"Public resource reference. Profile paths accept a username with an @ prefix, such as @openai, or the stable platform ID. Post paths accept the platform post ID or shortcode.","example":"950000000002","in":"path","name":"identifier","required":true,"schema":{"minLength":1,"type":"string"}},{"description":"Maximum accepted data age. The default is 24h.","example":"24h","in":"query","name":"freshness","required":false,"schema":{"default":"24h","enum":["live","24h","7d","30d"],"type":"string"}},{"description":"Opaque cursor returned by the previous page.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/SuccessEnvelope"},{"properties":{"data":{"items":{"$ref":"#/components/schemas/TikTokPost"},"type":"array"}},"required":["data","meta"],"type":"object"}]}}},"description":"A successful Test or Live response.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The locator, cursor, or query is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The API key is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Live billing does not permit this request.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource is private or workspace API access is security-suspended.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource does not exist.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer accepts this cursor. Restart pagination from the first page.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer serves this data. Retrying fails the same way.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request rate limit was exceeded.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"451":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The owner of this profile asked Openhandle not to serve it.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request failed internally.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The service is temporarily unavailable.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}}},"security":[{"OpenhandleKey":[]}],"summary":"List location posts","tags":["Tiktok","Post"],"x-openhandle-operation":"tiktok.location.posts.list","x-openhandle-sdk":{"operation":"list","paginated":true,"path":"tiktok.location.posts.list","scope":[{"name":"tiktok"},{"name":"location","parameter":"identifier","reference":"location"},{"name":"posts"}]},"x-openhandle-test-data":{"catalogUrl":"/v1/test-data?operation=tiktok.location.posts.list","contentHash":"sha256:7794275e0d6f248bb315a82bf631385a86ae70d2957dd815951fce7615602735","datasetVersion":"2026-10-27.2","example":{"identifier":"950000000002","query":"synthetic"}}}},"/v1/tiktok/music/{identifier}":{"get":{"description":"Return one public music by its native identifier. Test and Live use the same route, parameters, response schema, pagination, and errors. In Test, null means unavailable, not zero.","operationId":"tiktokMusicGet","parameters":[{"description":"Public resource reference. Profile paths accept a username with an @ prefix, such as @openai, or the stable platform ID. Post paths accept the platform post ID or shortcode.","example":"950000000003","in":"path","name":"identifier","required":true,"schema":{"minLength":1,"type":"string"}},{"description":"Maximum accepted data age. The default is 24h.","example":"24h","in":"query","name":"freshness","required":false,"schema":{"default":"24h","enum":["live","24h","7d","30d"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/SuccessEnvelope"},{"properties":{"data":{"$ref":"#/components/schemas/TikTokMusic"}},"required":["data"],"type":"object"}]}}},"description":"A successful Test or Live response.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The locator, cursor, or query is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The API key is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Live billing does not permit this request.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource is private or workspace API access is security-suspended.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource does not exist.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer serves this data. Retrying fails the same way.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request rate limit was exceeded.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"451":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The owner of this profile asked Openhandle not to serve it.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request failed internally.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The service is temporarily unavailable.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}}},"security":[{"OpenhandleKey":[]}],"summary":"Get a music","tags":["Tiktok","Music"],"x-openhandle-operation":"tiktok.music.get","x-openhandle-sdk":{"operation":"get","paginated":false,"path":"tiktok.music.get","scope":[{"name":"tiktok"},{"name":"music","parameter":"identifier","reference":"music"}]},"x-openhandle-test-data":{"catalogUrl":"/v1/test-data?operation=tiktok.music.get","contentHash":"sha256:7794275e0d6f248bb315a82bf631385a86ae70d2957dd815951fce7615602735","datasetVersion":"2026-10-27.2","example":{"identifier":"950000000003","query":"synthetic"}}}},"/v1/tiktok/music/{identifier}/posts":{"get":{"description":"Return a cursor-paginated collection of public posts. Test and Live use the same route, parameters, response schema, pagination, and errors. In Test, null means unavailable, not zero.","operationId":"tiktokMusicPostsList","parameters":[{"description":"Public resource reference. Profile paths accept a username with an @ prefix, such as @openai, or the stable platform ID. Post paths accept the platform post ID or shortcode.","example":"950000000003","in":"path","name":"identifier","required":true,"schema":{"minLength":1,"type":"string"}},{"description":"Maximum accepted data age. The default is 24h.","example":"24h","in":"query","name":"freshness","required":false,"schema":{"default":"24h","enum":["live","24h","7d","30d"],"type":"string"}},{"description":"Opaque cursor returned by the previous page.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/SuccessEnvelope"},{"properties":{"data":{"items":{"$ref":"#/components/schemas/TikTokPost"},"type":"array"}},"required":["data","meta"],"type":"object"}]}}},"description":"A successful Test or Live response.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The locator, cursor, or query is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The API key is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Live billing does not permit this request.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource is private or workspace API access is security-suspended.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource does not exist.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer accepts this cursor. Restart pagination from the first page.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer serves this data. Retrying fails the same way.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request rate limit was exceeded.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"451":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The owner of this profile asked Openhandle not to serve it.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request failed internally.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The service is temporarily unavailable.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}}},"security":[{"OpenhandleKey":[]}],"summary":"List music posts","tags":["Tiktok","Post"],"x-openhandle-operation":"tiktok.music.posts.list","x-openhandle-sdk":{"operation":"list","paginated":true,"path":"tiktok.music.posts.list","scope":[{"name":"tiktok"},{"name":"music","parameter":"identifier","reference":"music"},{"name":"posts"}]},"x-openhandle-test-data":{"catalogUrl":"/v1/test-data?operation=tiktok.music.posts.list","contentHash":"sha256:7794275e0d6f248bb315a82bf631385a86ae70d2957dd815951fce7615602735","datasetVersion":"2026-10-27.2","example":{"identifier":"950000000003","query":"synthetic"}}}},"/v1/tiktok/posts/{identifier}":{"get":{"description":"Get a post by a canonical platform identifier. URLs must be converted before calling a data endpoint. Test and Live use the same route, parameters, response schema, pagination, and errors. In Test, null means unavailable, not zero.","operationId":"tiktokPostGet","parameters":[{"description":"Public resource reference. Profile paths accept a username with an @ prefix, such as @openai, or the stable platform ID. Post paths accept the platform post ID or shortcode.","example":"920100000000000001","in":"path","name":"identifier","required":true,"schema":{"minLength":1,"type":"string"}},{"description":"Maximum accepted data age. The default is 24h.","example":"24h","in":"query","name":"freshness","required":false,"schema":{"default":"24h","enum":["live","24h","7d","30d"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/SuccessEnvelope"},{"properties":{"data":{"$ref":"#/components/schemas/TikTokPost"}},"required":["data"],"type":"object"}]}}},"description":"A successful Test or Live response.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The locator, cursor, or query is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The API key is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Live billing does not permit this request.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource is private or workspace API access is security-suspended.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource does not exist.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer serves this data. Retrying fails the same way.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request rate limit was exceeded.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"451":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The owner of this profile asked Openhandle not to serve it.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request failed internally.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The service is temporarily unavailable.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}}},"security":[{"OpenhandleKey":[]}],"summary":"Get a post","tags":["Tiktok","Post"],"x-openhandle-operation":"tiktok.post.get","x-openhandle-sdk":{"operation":"get","paginated":false,"path":"tiktok.post.get","scope":[{"name":"tiktok"},{"name":"post","parameter":"identifier","reference":"post"}]},"x-openhandle-test-data":{"catalogUrl":"/v1/test-data?operation=tiktok.post.get","contentHash":"sha256:7794275e0d6f248bb315a82bf631385a86ae70d2957dd815951fce7615602735","datasetVersion":"2026-10-27.2","example":{"identifier":"920100000000000001"}}}},"/v1/tiktok/posts/{identifier}/comments":{"get":{"description":"List post comments by a canonical platform identifier. URLs must be converted before calling a data endpoint. Test and Live use the same route, parameters, response schema, pagination, and errors. In Test, null means unavailable, not zero.","operationId":"tiktokPostCommentsList","parameters":[{"description":"Public resource reference. Profile paths accept a username with an @ prefix, such as @openai, or the stable platform ID. Post paths accept the platform post ID or shortcode.","example":"920100000000000001","in":"path","name":"identifier","required":true,"schema":{"minLength":1,"type":"string"}},{"description":"Maximum accepted data age. The default is 24h.","example":"24h","in":"query","name":"freshness","required":false,"schema":{"default":"24h","enum":["live","24h","7d","30d"],"type":"string"}},{"description":"Opaque cursor returned by the previous page.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/SuccessEnvelope"},{"properties":{"data":{"items":{"$ref":"#/components/schemas/TikTokComment"},"type":"array"}},"required":["data","meta"],"type":"object"}]}}},"description":"A successful Test or Live response.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The locator, cursor, or query is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The API key is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Live billing does not permit this request.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource is private or workspace API access is security-suspended.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource does not exist.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer accepts this cursor. Restart pagination from the first page.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer serves this data. Retrying fails the same way.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request rate limit was exceeded.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"451":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The owner of this profile asked Openhandle not to serve it.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request failed internally.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The service is temporarily unavailable.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}}},"security":[{"OpenhandleKey":[]}],"summary":"List post comments","tags":["Tiktok","Post"],"x-openhandle-operation":"tiktok.post.comments.list","x-openhandle-sdk":{"operation":"list","paginated":true,"path":"tiktok.post.comments.list","scope":[{"name":"tiktok"},{"name":"post","parameter":"identifier","reference":"post"},{"name":"comments"}]},"x-openhandle-test-data":{"catalogUrl":"/v1/test-data?operation=tiktok.post.comments.list","contentHash":"sha256:7794275e0d6f248bb315a82bf631385a86ae70d2957dd815951fce7615602735","datasetVersion":"2026-10-27.2","example":{"identifier":"920100000000000001"}}}},"/v1/tiktok/posts/{identifier}/comments/{comment_id}/replies":{"get":{"description":"Return a stable page of replies for one comment. Use find_test_data to discover compatible post and comment IDs. Test and Live use the same route, parameters, response schema, pagination, and errors. In Test, null means unavailable, not zero.","operationId":"tiktokCommentRepliesList","parameters":[{"description":"Public resource reference. Profile paths accept a username with an @ prefix, such as @openai, or the stable platform ID. Post paths accept the platform post ID or shortcode.","example":"920100000000000001","in":"path","name":"identifier","required":true,"schema":{"minLength":1,"type":"string"}},{"description":"Opaque native comment ID.","example":"920200000000000001","in":"path","name":"comment_id","required":true,"schema":{"minLength":1,"type":"string"}},{"description":"Maximum accepted data age. The default is 24h.","example":"24h","in":"query","name":"freshness","required":false,"schema":{"default":"24h","enum":["live","24h","7d","30d"],"type":"string"}},{"description":"Opaque cursor returned by the previous page.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/SuccessEnvelope"},{"properties":{"data":{"items":{"$ref":"#/components/schemas/TikTokComment"},"type":"array"}},"required":["data","meta"],"type":"object"}]}}},"description":"A successful Test or Live response.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The locator, cursor, or query is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The API key is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Live billing does not permit this request.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource is private or workspace API access is security-suspended.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource does not exist.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer accepts this cursor. Restart pagination from the first page.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer serves this data. Retrying fails the same way.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request rate limit was exceeded.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"451":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The owner of this profile asked Openhandle not to serve it.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request failed internally.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The service is temporarily unavailable.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}}},"security":[{"OpenhandleKey":[]}],"summary":"List comment replies","tags":["Tiktok","Comment"],"x-openhandle-operation":"tiktok.comment.replies.list","x-openhandle-sdk":{"operation":"list","paginated":true,"path":"tiktok.post.comment.replies.list","scope":[{"name":"tiktok"},{"name":"post","parameter":"identifier","reference":"post"},{"name":"comment","parameter":"comment_id","reference":"comment"},{"name":"replies"}]},"x-openhandle-test-data":{"catalogUrl":"/v1/test-data?operation=tiktok.comment.replies.list","contentHash":"sha256:7794275e0d6f248bb315a82bf631385a86ae70d2957dd815951fce7615602735","datasetVersion":"2026-10-27.2","example":{"comment_id":"920200000000000001","identifier":"920100000000000001","post_id":"920100000000000001"}}}},"/v1/tiktok/profiles/{identifier}":{"get":{"description":"Return one public profile. Use @username or a platform ID as the identifier. Test and Live use the same route, parameters, response schema, pagination, and errors. In Test, null means unavailable, not zero.","operationId":"tiktokProfileGet","parameters":[{"description":"Public resource reference. Profile paths accept a username with an @ prefix, such as @openai, or the stable platform ID. Post paths accept the platform post ID or shortcode.","example":"@pixel_orchard_tt_test","in":"path","name":"identifier","required":true,"schema":{"minLength":1,"type":"string"}},{"description":"Maximum accepted data age. The default is 24h.","example":"24h","in":"query","name":"freshness","required":false,"schema":{"default":"24h","enum":["live","24h","7d","30d"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/SuccessEnvelope"},{"properties":{"data":{"$ref":"#/components/schemas/TikTokProfile"}},"required":["data"],"type":"object"}]}}},"description":"A successful Test or Live response.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The locator, cursor, or query is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The API key is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Live billing does not permit this request.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource is private or workspace API access is security-suspended.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource does not exist.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer serves this data. Retrying fails the same way.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request rate limit was exceeded.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"451":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The owner of this profile asked Openhandle not to serve it.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request failed internally.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The service is temporarily unavailable.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}}},"security":[{"OpenhandleKey":[]}],"summary":"Get a profile","tags":["Tiktok","Profile"],"x-openhandle-operation":"tiktok.profile.get","x-openhandle-sdk":{"operation":"get","paginated":false,"path":"tiktok.profile.get","scope":[{"name":"tiktok"},{"name":"profile","parameter":"identifier","reference":"profile"}]},"x-openhandle-test-data":{"catalogUrl":"/v1/test-data?operation=tiktok.profile.get","contentHash":"sha256:7794275e0d6f248bb315a82bf631385a86ae70d2957dd815951fce7615602735","datasetVersion":"2026-10-27.2","example":{"identifier":"@pixel_orchard_tt_test"}}}},"/v1/tiktok/profiles/{identifier}/followers":{"get":{"description":"Return a cursor-paginated collection of Tiktok profiles. Test and Live use the same route, parameters, response schema, pagination, and errors. In Test, null means unavailable, not zero.","operationId":"tiktokProfileFollowersList","parameters":[{"description":"Public resource reference. Profile paths accept a username with an @ prefix, such as @openai, or the stable platform ID. Post paths accept the platform post ID or shortcode.","example":"@pixel_orchard_tt_test","in":"path","name":"identifier","required":true,"schema":{"minLength":1,"type":"string"}},{"description":"Maximum accepted data age. The default is 24h.","example":"24h","in":"query","name":"freshness","required":false,"schema":{"default":"24h","enum":["live","24h","7d","30d"],"type":"string"}},{"description":"Opaque cursor returned by the previous page.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/SuccessEnvelope"},{"properties":{"data":{"items":{"$ref":"#/components/schemas/TikTokProfile"},"type":"array"}},"required":["data","meta"],"type":"object"}]}}},"description":"A successful Test or Live response.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The locator, cursor, or query is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The API key is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Live billing does not permit this request.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource is private or workspace API access is security-suspended.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource does not exist.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer accepts this cursor. Restart pagination from the first page.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer serves this data. Retrying fails the same way.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request rate limit was exceeded.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"451":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The owner of this profile asked Openhandle not to serve it.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request failed internally.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The service is temporarily unavailable.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}}},"security":[{"OpenhandleKey":[]}],"summary":"List profile followers","tags":["Tiktok","Profile"],"x-openhandle-operation":"tiktok.profile.followers.list","x-openhandle-sdk":{"operation":"list","paginated":true,"path":"tiktok.profile.followers.list","scope":[{"name":"tiktok"},{"name":"profile","parameter":"identifier","reference":"profile"},{"name":"followers"}]},"x-openhandle-test-data":{"catalogUrl":"/v1/test-data?operation=tiktok.profile.followers.list","contentHash":"sha256:7794275e0d6f248bb315a82bf631385a86ae70d2957dd815951fce7615602735","datasetVersion":"2026-10-27.2","example":{"identifier":"@pixel_orchard_tt_test"}}}},"/v1/tiktok/profiles/{identifier}/following":{"get":{"description":"Return a cursor-paginated collection of Tiktok profiles. Test and Live use the same route, parameters, response schema, pagination, and errors. In Test, null means unavailable, not zero.","operationId":"tiktokProfileFollowingList","parameters":[{"description":"Public resource reference. Profile paths accept a username with an @ prefix, such as @openai, or the stable platform ID. Post paths accept the platform post ID or shortcode.","example":"@pixel_orchard_tt_test","in":"path","name":"identifier","required":true,"schema":{"minLength":1,"type":"string"}},{"description":"Maximum accepted data age. The default is 24h.","example":"24h","in":"query","name":"freshness","required":false,"schema":{"default":"24h","enum":["live","24h","7d","30d"],"type":"string"}},{"description":"Opaque cursor returned by the previous page.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/SuccessEnvelope"},{"properties":{"data":{"items":{"$ref":"#/components/schemas/TikTokProfile"},"type":"array"}},"required":["data","meta"],"type":"object"}]}}},"description":"A successful Test or Live response.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The locator, cursor, or query is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The API key is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Live billing does not permit this request.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource is private or workspace API access is security-suspended.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource does not exist.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer accepts this cursor. Restart pagination from the first page.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer serves this data. Retrying fails the same way.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request rate limit was exceeded.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"451":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The owner of this profile asked Openhandle not to serve it.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request failed internally.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The service is temporarily unavailable.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}}},"security":[{"OpenhandleKey":[]}],"summary":"List profile following","tags":["Tiktok","Profile"],"x-openhandle-operation":"tiktok.profile.following.list","x-openhandle-sdk":{"operation":"list","paginated":true,"path":"tiktok.profile.following.list","scope":[{"name":"tiktok"},{"name":"profile","parameter":"identifier","reference":"profile"},{"name":"following"}]},"x-openhandle-test-data":{"catalogUrl":"/v1/test-data?operation=tiktok.profile.following.list","contentHash":"sha256:7794275e0d6f248bb315a82bf631385a86ae70d2957dd815951fce7615602735","datasetVersion":"2026-10-27.2","example":{"identifier":"@pixel_orchard_tt_test"}}}},"/v1/tiktok/profiles/{identifier}/liked-posts":{"get":{"description":"Return a cursor-paginated collection of a public Tiktok profile's liked posts. Test and Live use the same route, parameters, response schema, pagination, and errors. In Test, null means unavailable, not zero.","operationId":"tiktokProfileLiked_postsList","parameters":[{"description":"Public resource reference. Profile paths accept a username with an @ prefix, such as @openai, or the stable platform ID. Post paths accept the platform post ID or shortcode.","example":"@pixel_orchard_tt_test","in":"path","name":"identifier","required":true,"schema":{"minLength":1,"type":"string"}},{"description":"Maximum accepted data age. The default is 24h.","example":"24h","in":"query","name":"freshness","required":false,"schema":{"default":"24h","enum":["live","24h","7d","30d"],"type":"string"}},{"description":"Opaque cursor returned by the previous page.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/SuccessEnvelope"},{"properties":{"data":{"items":{"$ref":"#/components/schemas/TikTokPost"},"type":"array"}},"required":["data","meta"],"type":"object"}]}}},"description":"A successful Test or Live response.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The locator, cursor, or query is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The API key is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Live billing does not permit this request.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource is private or workspace API access is security-suspended.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource does not exist.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer accepts this cursor. Restart pagination from the first page.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer serves this data. Retrying fails the same way.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request rate limit was exceeded.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"451":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The owner of this profile asked Openhandle not to serve it.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request failed internally.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The service is temporarily unavailable.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}}},"security":[{"OpenhandleKey":[]}],"summary":"List profile liked posts","tags":["Tiktok","Post"],"x-openhandle-operation":"tiktok.profile.liked.posts.list","x-openhandle-sdk":{"operation":"list","paginated":true,"path":"tiktok.profile.likedPosts.list","scope":[{"name":"tiktok"},{"name":"profile","parameter":"identifier","reference":"profile"},{"name":"likedPosts"}]},"x-openhandle-test-data":{"catalogUrl":"/v1/test-data?operation=tiktok.profile.liked.posts.list","contentHash":"sha256:7794275e0d6f248bb315a82bf631385a86ae70d2957dd815951fce7615602735","datasetVersion":"2026-10-27.2","example":{"identifier":"@pixel_orchard_tt_test"}}}},"/v1/tiktok/profiles/{identifier}/playlists":{"get":{"description":"List profile playlists from public Tiktok data. Test and Live use the same route, parameters, response schema, pagination, and errors. In Test, null means unavailable, not zero.","operationId":"Tiktok_profile_playlists_list","parameters":[{"description":"Public resource reference. Profile paths accept a username with an @ prefix, such as @openai, or the stable platform ID. Post paths accept the platform post ID or shortcode.","example":"@pixel_orchard_tt_test","in":"path","name":"identifier","required":true,"schema":{"minLength":1,"type":"string"}},{"description":"Maximum accepted data age. The default is 24h.","example":"24h","in":"query","name":"freshness","required":false,"schema":{"default":"24h","enum":["live","24h","7d","30d"],"type":"string"}},{"description":"Opaque cursor returned by the previous page.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/SuccessEnvelope"},{"properties":{"data":{"items":{"$ref":"#/components/schemas/TikTokPlaylist"},"type":"array"}},"required":["data","meta"],"type":"object"}]}}},"description":"A successful Test or Live response.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The locator, cursor, or query is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The API key is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Live billing does not permit this request.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource is private or workspace API access is security-suspended.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource does not exist.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer accepts this cursor. Restart pagination from the first page.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer serves this data. Retrying fails the same way.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request rate limit was exceeded.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"451":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The owner of this profile asked Openhandle not to serve it.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request failed internally.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The service is temporarily unavailable.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}}},"security":[{"OpenhandleKey":[]}],"summary":"List profile playlists","tags":["Tiktok","Entity"],"x-openhandle-operation":"tiktok.profile.playlists.list","x-openhandle-sdk":{"operation":"list","paginated":true,"path":"tiktok.profile.playlists.list","scope":[{"name":"tiktok"},{"name":"profile","parameter":"identifier","reference":"profile"},{"name":"playlists"}]},"x-openhandle-test-data":{"catalogUrl":"/v1/test-data?operation=tiktok.profile.playlists.list","contentHash":"sha256:7794275e0d6f248bb315a82bf631385a86ae70d2957dd815951fce7615602735","datasetVersion":"2026-10-27.2","example":{"category_id":"950000000008","comment":"synthetic","comment_id":"920200000000000001","identifier":"@pixel_orchard_tt_test","ids":"950000000007","playlist_id":"950000000006","post_id":"920100000000000001","product_source_type":"0","query":"synthetic","rank_type":"daily","room_id":"950000000009","user_id":"920000000001"}}}},"/v1/tiktok/profiles/{identifier}/playlists/{playlist_id}":{"get":{"description":"Get a playlist from public Tiktok data. Test and Live use the same route, parameters, response schema, pagination, and errors. In Test, null means unavailable, not zero.","operationId":"Tiktok_profile_playlist_get","parameters":[{"description":"Public resource reference. Profile paths accept a username with an @ prefix, such as @openai, or the stable platform ID. Post paths accept the platform post ID or shortcode.","example":"@pixel_orchard_tt_test","in":"path","name":"identifier","required":true,"schema":{"minLength":1,"type":"string"}},{"description":"Opaque native playlist ID.","example":"950000000006","in":"path","name":"playlist_id","required":true,"schema":{"minLength":1,"type":"string"}},{"description":"Maximum accepted data age. The default is 24h.","example":"24h","in":"query","name":"freshness","required":false,"schema":{"default":"24h","enum":["live","24h","7d","30d"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/SuccessEnvelope"},{"properties":{"data":{"$ref":"#/components/schemas/TikTokPlaylist"}},"required":["data"],"type":"object"}]}}},"description":"A successful Test or Live response.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The locator, cursor, or query is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The API key is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Live billing does not permit this request.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource is private or workspace API access is security-suspended.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource does not exist.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer serves this data. Retrying fails the same way.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request rate limit was exceeded.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"451":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The owner of this profile asked Openhandle not to serve it.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request failed internally.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The service is temporarily unavailable.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}}},"security":[{"OpenhandleKey":[]}],"summary":"Get a playlist","tags":["Tiktok","Entity"],"x-openhandle-operation":"tiktok.profile.playlist.get","x-openhandle-sdk":{"operation":"get","paginated":false,"path":"tiktok.profile.playlist.get","scope":[{"name":"tiktok"},{"name":"profile","parameter":"identifier","reference":"profile"},{"name":"playlist","parameter":"playlist_id","reference":"playlist"}]},"x-openhandle-test-data":{"catalogUrl":"/v1/test-data?operation=tiktok.profile.playlist.get","contentHash":"sha256:7794275e0d6f248bb315a82bf631385a86ae70d2957dd815951fce7615602735","datasetVersion":"2026-10-27.2","example":{"category_id":"950000000008","comment":"synthetic","comment_id":"920200000000000001","identifier":"@pixel_orchard_tt_test","ids":"950000000007","playlist_id":"950000000006","post_id":"920100000000000001","product_source_type":"0","query":"synthetic","rank_type":"daily","room_id":"950000000009","user_id":"920000000001"}}}},"/v1/tiktok/profiles/{identifier}/playlists/{playlist_id}/posts":{"get":{"description":"Return a cursor-paginated collection of posts in a public TikTok profile playlist. Test and Live use the same route, parameters, response schema, pagination, and errors. In Test, null means unavailable, not zero.","operationId":"tiktokProfilePlaylistPostsList","parameters":[{"description":"Public resource reference. Profile paths accept a username with an @ prefix, such as @openai, or the stable platform ID. Post paths accept the platform post ID or shortcode.","example":"@pixel_orchard_tt_test","in":"path","name":"identifier","required":true,"schema":{"minLength":1,"type":"string"}},{"description":"Opaque native playlist ID.","example":"950000000006","in":"path","name":"playlist_id","required":true,"schema":{"minLength":1,"type":"string"}},{"description":"Maximum accepted data age. The default is 24h.","example":"24h","in":"query","name":"freshness","required":false,"schema":{"default":"24h","enum":["live","24h","7d","30d"],"type":"string"}},{"description":"Opaque cursor returned by the previous page.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/SuccessEnvelope"},{"properties":{"data":{"items":{"$ref":"#/components/schemas/TikTokPost"},"type":"array"}},"required":["data","meta"],"type":"object"}]}}},"description":"A successful Test or Live response.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The locator, cursor, or query is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The API key is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Live billing does not permit this request.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource is private or workspace API access is security-suspended.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource does not exist.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer accepts this cursor. Restart pagination from the first page.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer serves this data. Retrying fails the same way.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request rate limit was exceeded.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"451":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The owner of this profile asked Openhandle not to serve it.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request failed internally.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The service is temporarily unavailable.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}}},"security":[{"OpenhandleKey":[]}],"summary":"List playlist posts","tags":["Tiktok","Post"],"x-openhandle-operation":"tiktok.profile.playlist.posts.list","x-openhandle-sdk":{"operation":"list","paginated":true,"path":"tiktok.profile.playlist.posts.list","scope":[{"name":"tiktok"},{"name":"profile","parameter":"identifier","reference":"profile"},{"name":"playlist","parameter":"playlist_id","reference":"playlist"},{"name":"posts"}]},"x-openhandle-test-data":{"catalogUrl":"/v1/test-data?operation=tiktok.profile.playlist.posts.list","contentHash":"sha256:7794275e0d6f248bb315a82bf631385a86ae70d2957dd815951fce7615602735","datasetVersion":"2026-10-27.2","example":{"identifier":"@pixel_orchard_tt_test","playlist_id":"950000000006"}}}},"/v1/tiktok/profiles/{identifier}/posts":{"get":{"description":"Return a stable page of posts for one public profile. Test and Live use the same route, parameters, response schema, pagination, and errors. In Test, null means unavailable, not zero.","operationId":"tiktokProfilePostsList","parameters":[{"description":"Public resource reference. Profile paths accept a username with an @ prefix, such as @openai, or the stable platform ID. Post paths accept the platform post ID or shortcode.","example":"@pixel_orchard_tt_test","in":"path","name":"identifier","required":true,"schema":{"minLength":1,"type":"string"}},{"description":"Maximum accepted data age. The default is 24h.","example":"24h","in":"query","name":"freshness","required":false,"schema":{"default":"24h","enum":["live","24h","7d","30d"],"type":"string"}},{"description":"Opaque cursor returned by the previous page.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}},{"description":"Return posts captured at or after this RFC 3339 timestamp.","in":"query","name":"since","required":false,"schema":{"format":"date-time","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/SuccessEnvelope"},{"properties":{"data":{"items":{"$ref":"#/components/schemas/TikTokPost"},"type":"array"}},"required":["data","meta"],"type":"object"}]}}},"description":"A successful Test or Live response.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The locator, cursor, or query is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The API key is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Live billing does not permit this request.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource is private or workspace API access is security-suspended.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource does not exist.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer accepts this cursor. Restart pagination from the first page.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer serves this data. Retrying fails the same way.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request rate limit was exceeded.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"451":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The owner of this profile asked Openhandle not to serve it.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request failed internally.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The service is temporarily unavailable.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}}},"security":[{"OpenhandleKey":[]}],"summary":"List profile posts","tags":["Tiktok","Profile"],"x-openhandle-operation":"tiktok.profile.posts.list","x-openhandle-sdk":{"operation":"list","paginated":true,"path":"tiktok.profile.posts.list","scope":[{"name":"tiktok"},{"name":"profile","parameter":"identifier","reference":"profile"},{"name":"posts"}]},"x-openhandle-test-data":{"catalogUrl":"/v1/test-data?operation=tiktok.profile.posts.list","contentHash":"sha256:7794275e0d6f248bb315a82bf631385a86ae70d2957dd815951fce7615602735","datasetVersion":"2026-10-27.2","example":{"identifier":"@pixel_orchard_tt_test"}}}},"/v1/tiktok/search/hashtags":{"get":{"description":"Search public Tiktok hashtags with cursor pagination. Test and Live use the same route, parameters, response schema, pagination, and errors. In Test, null means unavailable, not zero.","operationId":"tiktokSearchHashtags","parameters":[{"description":"Public search query.","example":"synthetic","in":"query","name":"q","required":true,"schema":{"minLength":1,"type":"string"}},{"description":"Maximum accepted data age. The default is 24h.","example":"24h","in":"query","name":"freshness","required":false,"schema":{"default":"24h","enum":["live","24h","7d","30d"],"type":"string"}},{"description":"Opaque cursor returned by the previous page.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/SuccessEnvelope"},{"properties":{"data":{"items":{"$ref":"#/components/schemas/TikTokHashtag"},"type":"array"}},"required":["data","meta"],"type":"object"}]}}},"description":"A successful Test or Live response.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The locator, cursor, or query is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The API key is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Live billing does not permit this request.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource is private or workspace API access is security-suspended.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource does not exist.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer accepts this cursor. Restart pagination from the first page.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer serves this data. Retrying fails the same way.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request rate limit was exceeded.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"451":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The owner of this profile asked Openhandle not to serve it.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request failed internally.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The service is temporarily unavailable.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}}},"security":[{"OpenhandleKey":[]}],"summary":"Search Tiktok hashtags","tags":["Tiktok","Hashtag"],"x-openhandle-operation":"tiktok.search.hashtags.list","x-openhandle-sdk":{"operation":"list","paginated":true,"path":"tiktok.search.hashtags.list","scope":[{"name":"tiktok"},{"name":"search"},{"name":"hashtags"}]},"x-openhandle-test-data":{"catalogUrl":"/v1/test-data?operation=tiktok.search.hashtags.list","contentHash":"sha256:7794275e0d6f248bb315a82bf631385a86ae70d2957dd815951fce7615602735","datasetVersion":"2026-10-27.2","example":{"query":"synthetic"}}}},"/v1/tiktok/search/locations":{"get":{"description":"Search public Tiktok locations with cursor pagination. Test and Live use the same route, parameters, response schema, pagination, and errors. In Test, null means unavailable, not zero.","operationId":"tiktokSearchLocations","parameters":[{"description":"Public search query.","example":"synthetic","in":"query","name":"q","required":true,"schema":{"minLength":1,"type":"string"}},{"description":"Maximum accepted data age. The default is 24h.","example":"24h","in":"query","name":"freshness","required":false,"schema":{"default":"24h","enum":["live","24h","7d","30d"],"type":"string"}},{"description":"Opaque cursor returned by the previous page.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/SuccessEnvelope"},{"properties":{"data":{"items":{"$ref":"#/components/schemas/TikTokLocation"},"type":"array"}},"required":["data","meta"],"type":"object"}]}}},"description":"A successful Test or Live response.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The locator, cursor, or query is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The API key is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Live billing does not permit this request.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource is private or workspace API access is security-suspended.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource does not exist.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer accepts this cursor. Restart pagination from the first page.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer serves this data. Retrying fails the same way.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request rate limit was exceeded.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"451":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The owner of this profile asked Openhandle not to serve it.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request failed internally.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The service is temporarily unavailable.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}}},"security":[{"OpenhandleKey":[]}],"summary":"Search Tiktok locations","tags":["Tiktok","Location"],"x-openhandle-operation":"tiktok.search.locations.list","x-openhandle-sdk":{"operation":"list","paginated":true,"path":"tiktok.search.locations.list","scope":[{"name":"tiktok"},{"name":"search"},{"name":"locations"}]},"x-openhandle-test-data":{"catalogUrl":"/v1/test-data?operation=tiktok.search.locations.list","contentHash":"sha256:7794275e0d6f248bb315a82bf631385a86ae70d2957dd815951fce7615602735","datasetVersion":"2026-10-27.2","example":{"query":"synthetic"}}}},"/v1/tiktok/search/music":{"get":{"description":"Search public Tiktok music with cursor pagination. Test and Live use the same route, parameters, response schema, pagination, and errors. In Test, null means unavailable, not zero.","operationId":"tiktokSearchMusic","parameters":[{"description":"Public search query.","example":"synthetic","in":"query","name":"q","required":true,"schema":{"minLength":1,"type":"string"}},{"description":"Maximum accepted data age. The default is 24h.","example":"24h","in":"query","name":"freshness","required":false,"schema":{"default":"24h","enum":["live","24h","7d","30d"],"type":"string"}},{"description":"Opaque cursor returned by the previous page.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/SuccessEnvelope"},{"properties":{"data":{"items":{"$ref":"#/components/schemas/TikTokMusic"},"type":"array"}},"required":["data","meta"],"type":"object"}]}}},"description":"A successful Test or Live response.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The locator, cursor, or query is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The API key is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Live billing does not permit this request.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource is private or workspace API access is security-suspended.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource does not exist.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer accepts this cursor. Restart pagination from the first page.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer serves this data. Retrying fails the same way.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request rate limit was exceeded.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"451":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The owner of this profile asked Openhandle not to serve it.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request failed internally.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The service is temporarily unavailable.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}}},"security":[{"OpenhandleKey":[]}],"summary":"Search Tiktok music","tags":["Tiktok","Music"],"x-openhandle-operation":"tiktok.search.music.list","x-openhandle-sdk":{"operation":"list","paginated":true,"path":"tiktok.search.music.list","scope":[{"name":"tiktok"},{"name":"search"},{"name":"music"}]},"x-openhandle-test-data":{"catalogUrl":"/v1/test-data?operation=tiktok.search.music.list","contentHash":"sha256:7794275e0d6f248bb315a82bf631385a86ae70d2957dd815951fce7615602735","datasetVersion":"2026-10-27.2","example":{"query":"synthetic"}}}},"/v1/tiktok/search/posts":{"get":{"description":"Search public Tiktok posts with cursor pagination. Test and Live use the same route, parameters, response schema, pagination, and errors. In Test, null means unavailable, not zero.","operationId":"tiktokSearchPosts","parameters":[{"description":"Public search query.","example":"synthetic","in":"query","name":"q","required":true,"schema":{"minLength":1,"type":"string"}},{"description":"Maximum accepted data age. The default is 24h.","example":"24h","in":"query","name":"freshness","required":false,"schema":{"default":"24h","enum":["live","24h","7d","30d"],"type":"string"}},{"description":"Opaque cursor returned by the previous page.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/SuccessEnvelope"},{"properties":{"data":{"items":{"$ref":"#/components/schemas/TikTokPost"},"type":"array"}},"required":["data","meta"],"type":"object"}]}}},"description":"A successful Test or Live response.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The locator, cursor, or query is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The API key is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Live billing does not permit this request.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource is private or workspace API access is security-suspended.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource does not exist.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer accepts this cursor. Restart pagination from the first page.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer serves this data. Retrying fails the same way.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request rate limit was exceeded.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"451":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The owner of this profile asked Openhandle not to serve it.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request failed internally.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The service is temporarily unavailable.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}}},"security":[{"OpenhandleKey":[]}],"summary":"Search Tiktok posts","tags":["Tiktok","Post"],"x-openhandle-operation":"tiktok.search.posts.list","x-openhandle-sdk":{"operation":"list","paginated":true,"path":"tiktok.search.posts.list","scope":[{"name":"tiktok"},{"name":"search"},{"name":"posts"}]},"x-openhandle-test-data":{"catalogUrl":"/v1/test-data?operation=tiktok.search.posts.list","contentHash":"sha256:7794275e0d6f248bb315a82bf631385a86ae70d2957dd815951fce7615602735","datasetVersion":"2026-10-27.2","example":{"query":"synthetic"}}}},"/v1/tiktok/search/profiles":{"get":{"description":"Search public Tiktok profiles with cursor pagination. Test and Live use the same route, parameters, response schema, pagination, and errors. In Test, null means unavailable, not zero.","operationId":"tiktokSearchProfiles","parameters":[{"description":"Public search query.","example":"synthetic","in":"query","name":"q","required":true,"schema":{"minLength":1,"type":"string"}},{"description":"Maximum accepted data age. The default is 24h.","example":"24h","in":"query","name":"freshness","required":false,"schema":{"default":"24h","enum":["live","24h","7d","30d"],"type":"string"}},{"description":"Opaque cursor returned by the previous page.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/SuccessEnvelope"},{"properties":{"data":{"items":{"$ref":"#/components/schemas/TikTokProfile"},"type":"array"}},"required":["data","meta"],"type":"object"}]}}},"description":"A successful Test or Live response.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The locator, cursor, or query is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The API key is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Live billing does not permit this request.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource is private or workspace API access is security-suspended.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource does not exist.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer accepts this cursor. Restart pagination from the first page.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer serves this data. Retrying fails the same way.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request rate limit was exceeded.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"451":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The owner of this profile asked Openhandle not to serve it.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request failed internally.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The service is temporarily unavailable.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}}},"security":[{"OpenhandleKey":[]}],"summary":"Search Tiktok profiles","tags":["Tiktok","Profile"],"x-openhandle-operation":"tiktok.search.profiles.list","x-openhandle-sdk":{"operation":"list","paginated":true,"path":"tiktok.search.profiles.list","scope":[{"name":"tiktok"},{"name":"search"},{"name":"profiles"}]},"x-openhandle-test-data":{"catalogUrl":"/v1/test-data?operation=tiktok.search.profiles.list","contentHash":"sha256:7794275e0d6f248bb315a82bf631385a86ae70d2957dd815951fce7615602735","datasetVersion":"2026-10-27.2","example":{"query":"synthetic"}}}},"/v1/tiktok/trending/categories":{"get":{"description":"Return TikTok trending categories. Test and Live use the same route, parameters, response schema, pagination, and errors. In Test, null means unavailable, not zero.","operationId":"tiktokTrendingCategoriesList","parameters":[{"description":"Maximum accepted data age. The default is 24h.","example":"24h","in":"query","name":"freshness","required":false,"schema":{"default":"24h","enum":["live","24h","7d","30d"],"type":"string"}},{"description":"Opaque cursor returned by the previous page.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/SuccessEnvelope"},{"properties":{"data":{"items":{"$ref":"#/components/schemas/TikTokCategory"},"type":"array"}},"required":["data","meta"],"type":"object"}]}}},"description":"A successful Test or Live response.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The locator, cursor, or query is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The API key is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Live billing does not permit this request.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource is private or workspace API access is security-suspended.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource does not exist.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer accepts this cursor. Restart pagination from the first page.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer serves this data. Retrying fails the same way.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request rate limit was exceeded.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"451":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The owner of this profile asked Openhandle not to serve it.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request failed internally.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The service is temporarily unavailable.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}}},"security":[{"OpenhandleKey":[]}],"summary":"List trending categories","tags":["Tiktok","Category"],"x-openhandle-operation":"tiktok.trending.categories.list","x-openhandle-sdk":{"operation":"list","paginated":true,"path":"tiktok.trending.categories.list","scope":[{"name":"tiktok"},{"name":"trending"},{"name":"categories"}]},"x-openhandle-test-data":{"catalogUrl":"/v1/test-data?operation=tiktok.trending.categories.list","contentHash":"sha256:7794275e0d6f248bb315a82bf631385a86ae70d2957dd815951fce7615602735","datasetVersion":"2026-10-27.2","example":{"id":"950000000004","query":""}}}},"/v1/tiktok/trending/music":{"get":{"description":"Return TikTok's public Top 50 music chart for the configured provider region. Test and Live use the same route, parameters, response schema, pagination, and errors. In Test, null means unavailable, not zero.","operationId":"tiktokTrendingMusicList","parameters":[{"description":"Maximum accepted data age. The default is 24h.","example":"24h","in":"query","name":"freshness","required":false,"schema":{"default":"24h","enum":["live","24h","7d","30d"],"type":"string"}},{"description":"Opaque cursor returned by the previous page.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/SuccessEnvelope"},{"properties":{"data":{"items":{"$ref":"#/components/schemas/TikTokMusic"},"type":"array"}},"required":["data","meta"],"type":"object"}]}}},"description":"A successful Test or Live response.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The locator, cursor, or query is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The API key is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Live billing does not permit this request.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource is private or workspace API access is security-suspended.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource does not exist.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer accepts this cursor. Restart pagination from the first page.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer serves this data. Retrying fails the same way.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request rate limit was exceeded.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"451":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The owner of this profile asked Openhandle not to serve it.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request failed internally.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The service is temporarily unavailable.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}}},"security":[{"OpenhandleKey":[]}],"summary":"List trending music","tags":["Tiktok","Music"],"x-openhandle-operation":"tiktok.trending.music.list","x-openhandle-sdk":{"operation":"list","paginated":true,"path":"tiktok.trending.music.list","scope":[{"name":"tiktok"},{"name":"trending"},{"name":"music"}]},"x-openhandle-test-data":{"catalogUrl":"/v1/test-data?operation=tiktok.trending.music.list","contentHash":"sha256:7794275e0d6f248bb315a82bf631385a86ae70d2957dd815951fce7615602735","datasetVersion":"2026-10-27.2","example":{"id":"950000000003","q":"synthetic","query":"synthetic"}}}},"/v1/tiktok/trending/posts":{"get":{"description":"Return TikTok's public recommended feed. Test and Live use the same route, parameters, response schema, pagination, and errors. In Test, null means unavailable, not zero.","operationId":"tiktokTrendingPostsList","parameters":[{"description":"Maximum accepted data age. The default is 24h.","example":"24h","in":"query","name":"freshness","required":false,"schema":{"default":"24h","enum":["live","24h","7d","30d"],"type":"string"}},{"description":"Opaque cursor returned by the previous page.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/SuccessEnvelope"},{"properties":{"data":{"items":{"$ref":"#/components/schemas/TikTokPost"},"type":"array"}},"required":["data","meta"],"type":"object"}]}}},"description":"A successful Test or Live response.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The locator, cursor, or query is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The API key is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Live billing does not permit this request.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource is private or workspace API access is security-suspended.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource does not exist.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer accepts this cursor. Restart pagination from the first page.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer serves this data. Retrying fails the same way.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request rate limit was exceeded.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"451":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The owner of this profile asked Openhandle not to serve it.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request failed internally.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The service is temporarily unavailable.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}}},"security":[{"OpenhandleKey":[]}],"summary":"List trending posts","tags":["Tiktok","Post"],"x-openhandle-operation":"tiktok.trending.posts.list","x-openhandle-sdk":{"operation":"list","paginated":true,"path":"tiktok.trending.posts.list","scope":[{"name":"tiktok"},{"name":"trending"},{"name":"posts"}]},"x-openhandle-test-data":{"catalogUrl":"/v1/test-data?operation=tiktok.trending.posts.list","contentHash":"sha256:7794275e0d6f248bb315a82bf631385a86ae70d2957dd815951fce7615602735","datasetVersion":"2026-10-27.2","example":{"handle":"pixel_orchard_tt_test","id":"920100000000000001","platform_id":"920000000001","query":"","url":"https://www.tiktok.com/@pixel_orchard_tt_test/video/920100000000000001"}}}},"/v1/twitter/lists/{identifier}/posts":{"get":{"description":"Return the cursor-paginated timeline for a Twitter list. Test and Live use the same route, parameters, response schema, pagination, and errors. In Test, null means unavailable, not zero.","operationId":"twitterListPostsList","parameters":[{"description":"Public resource reference. Profile paths accept a username with an @ prefix, such as @openai, or the stable platform ID. Post paths accept the platform post ID or shortcode.","example":"950000000005","in":"path","name":"identifier","required":true,"schema":{"minLength":1,"type":"string"}},{"description":"Maximum accepted data age. The default is 24h.","example":"24h","in":"query","name":"freshness","required":false,"schema":{"default":"24h","enum":["live","24h","7d","30d"],"type":"string"}},{"description":"Opaque cursor returned by the previous page.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/SuccessEnvelope"},{"properties":{"data":{"items":{"$ref":"#/components/schemas/TwitterPost"},"type":"array"}},"required":["data","meta"],"type":"object"}]}}},"description":"A successful Test or Live response.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The locator, cursor, or query is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The API key is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Live billing does not permit this request.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource is private or workspace API access is security-suspended.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource does not exist.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer accepts this cursor. Restart pagination from the first page.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer serves this data. Retrying fails the same way.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request rate limit was exceeded.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"451":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The owner of this profile asked Openhandle not to serve it.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request failed internally.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The service is temporarily unavailable.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}}},"security":[{"OpenhandleKey":[]}],"summary":"List Twitter list posts","tags":["Twitter","Post"],"x-openhandle-operation":"twitter.list.posts.list","x-openhandle-sdk":{"operation":"list","paginated":true,"path":"twitter.list.posts.list","scope":[{"name":"twitter"},{"name":"list","parameter":"identifier","reference":"list"},{"name":"posts"}]},"x-openhandle-test-data":{"catalogUrl":"/v1/test-data?operation=twitter.list.posts.list","contentHash":"sha256:7794275e0d6f248bb315a82bf631385a86ae70d2957dd815951fce7615602735","datasetVersion":"2026-10-27.2","example":{"identifier":"950000000005"}}}},"/v1/twitter/posts/{identifier}":{"get":{"description":"Get a post by a canonical platform identifier. URLs must be converted before calling a data endpoint. Test and Live use the same route, parameters, response schema, pagination, and errors. In Test, null means unavailable, not zero.","operationId":"twitterPostGet","parameters":[{"description":"Public resource reference. Profile paths accept a username with an @ prefix, such as @openai, or the stable platform ID. Post paths accept the platform post ID or shortcode.","example":"940100000000000001","in":"path","name":"identifier","required":true,"schema":{"minLength":1,"type":"string"}},{"description":"Maximum accepted data age. The default is 24h.","example":"24h","in":"query","name":"freshness","required":false,"schema":{"default":"24h","enum":["live","24h","7d","30d"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/SuccessEnvelope"},{"properties":{"data":{"$ref":"#/components/schemas/TwitterPost"}},"required":["data"],"type":"object"}]}}},"description":"A successful Test or Live response.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The locator, cursor, or query is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The API key is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Live billing does not permit this request.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource is private or workspace API access is security-suspended.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource does not exist.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer serves this data. Retrying fails the same way.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request rate limit was exceeded.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"451":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The owner of this profile asked Openhandle not to serve it.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request failed internally.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The service is temporarily unavailable.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}}},"security":[{"OpenhandleKey":[]}],"summary":"Get a post","tags":["Twitter","Post"],"x-openhandle-operation":"twitter.post.get","x-openhandle-sdk":{"operation":"get","paginated":false,"path":"twitter.post.get","scope":[{"name":"twitter"},{"name":"post","parameter":"identifier","reference":"post"}]},"x-openhandle-test-data":{"catalogUrl":"/v1/test-data?operation=twitter.post.get","contentHash":"sha256:7794275e0d6f248bb315a82bf631385a86ae70d2957dd815951fce7615602735","datasetVersion":"2026-10-27.2","example":{"identifier":"940100000000000001"}}}},"/v1/twitter/posts/{identifier}/comments":{"get":{"description":"List post comments by a canonical platform identifier. URLs must be converted before calling a data endpoint. Test and Live use the same route, parameters, response schema, pagination, and errors. In Test, null means unavailable, not zero.","operationId":"twitterPostCommentsList","parameters":[{"description":"Public resource reference. Profile paths accept a username with an @ prefix, such as @openai, or the stable platform ID. Post paths accept the platform post ID or shortcode.","example":"940100000000000001","in":"path","name":"identifier","required":true,"schema":{"minLength":1,"type":"string"}},{"description":"Maximum accepted data age. The default is 24h.","example":"24h","in":"query","name":"freshness","required":false,"schema":{"default":"24h","enum":["live","24h","7d","30d"],"type":"string"}},{"description":"Opaque cursor returned by the previous page.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/SuccessEnvelope"},{"properties":{"data":{"items":{"$ref":"#/components/schemas/TwitterPost"},"type":"array"}},"required":["data","meta"],"type":"object"}]}}},"description":"A successful Test or Live response.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The locator, cursor, or query is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The API key is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Live billing does not permit this request.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource is private or workspace API access is security-suspended.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource does not exist.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer accepts this cursor. Restart pagination from the first page.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer serves this data. Retrying fails the same way.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request rate limit was exceeded.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"451":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The owner of this profile asked Openhandle not to serve it.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request failed internally.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The service is temporarily unavailable.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}}},"security":[{"OpenhandleKey":[]}],"summary":"List post comments","tags":["Twitter","Post"],"x-openhandle-operation":"twitter.post.comments.list","x-openhandle-sdk":{"operation":"list","paginated":true,"path":"twitter.post.comments.list","scope":[{"name":"twitter"},{"name":"post","parameter":"identifier","reference":"post"},{"name":"comments"}]},"x-openhandle-test-data":{"catalogUrl":"/v1/test-data?operation=twitter.post.comments.list","contentHash":"sha256:7794275e0d6f248bb315a82bf631385a86ae70d2957dd815951fce7615602735","datasetVersion":"2026-10-27.2","example":{"identifier":"940100000000000001"}}}},"/v1/twitter/posts/{identifier}/comments/{comment_id}/replies":{"get":{"description":"Return a stable page of replies for one comment. Use find_test_data to discover compatible post and comment IDs. Test and Live use the same route, parameters, response schema, pagination, and errors. In Test, null means unavailable, not zero.","operationId":"twitterCommentRepliesList","parameters":[{"description":"Public resource reference. Profile paths accept a username with an @ prefix, such as @openai, or the stable platform ID. Post paths accept the platform post ID or shortcode.","example":"940100000000000001","in":"path","name":"identifier","required":true,"schema":{"minLength":1,"type":"string"}},{"description":"Opaque native comment ID.","example":"940200000000000001","in":"path","name":"comment_id","required":true,"schema":{"minLength":1,"type":"string"}},{"description":"Maximum accepted data age. The default is 24h.","example":"24h","in":"query","name":"freshness","required":false,"schema":{"default":"24h","enum":["live","24h","7d","30d"],"type":"string"}},{"description":"Opaque cursor returned by the previous page.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/SuccessEnvelope"},{"properties":{"data":{"items":{"$ref":"#/components/schemas/TwitterPost"},"type":"array"}},"required":["data","meta"],"type":"object"}]}}},"description":"A successful Test or Live response.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The locator, cursor, or query is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The API key is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Live billing does not permit this request.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource is private or workspace API access is security-suspended.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource does not exist.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer accepts this cursor. Restart pagination from the first page.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer serves this data. Retrying fails the same way.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request rate limit was exceeded.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"451":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The owner of this profile asked Openhandle not to serve it.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request failed internally.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The service is temporarily unavailable.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}}},"security":[{"OpenhandleKey":[]}],"summary":"List comment replies","tags":["Twitter","Comment"],"x-openhandle-operation":"twitter.comment.replies.list","x-openhandle-sdk":{"operation":"list","paginated":true,"path":"twitter.post.comment.replies.list","scope":[{"name":"twitter"},{"name":"post","parameter":"identifier","reference":"post"},{"name":"comment","parameter":"comment_id","reference":"comment"},{"name":"replies"}]},"x-openhandle-test-data":{"catalogUrl":"/v1/test-data?operation=twitter.comment.replies.list","contentHash":"sha256:7794275e0d6f248bb315a82bf631385a86ae70d2957dd815951fce7615602735","datasetVersion":"2026-10-27.2","example":{"comment_id":"940200000000000001","identifier":"940100000000000001","post_id":"940100000000000001"}}}},"/v1/twitter/posts/{identifier}/reposters":{"get":{"description":"Return public profiles that interacted with a Twitter post. Test and Live use the same route, parameters, response schema, pagination, and errors. In Test, null means unavailable, not zero.","operationId":"twitterPostRepostersList","parameters":[{"description":"Public resource reference. Profile paths accept a username with an @ prefix, such as @openai, or the stable platform ID. Post paths accept the platform post ID or shortcode.","example":"940100000000000001","in":"path","name":"identifier","required":true,"schema":{"minLength":1,"type":"string"}},{"description":"Maximum accepted data age. The default is 24h.","example":"24h","in":"query","name":"freshness","required":false,"schema":{"default":"24h","enum":["live","24h","7d","30d"],"type":"string"}},{"description":"Opaque cursor returned by the previous page.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/SuccessEnvelope"},{"properties":{"data":{"items":{"$ref":"#/components/schemas/TwitterProfile"},"type":"array"}},"required":["data","meta"],"type":"object"}]}}},"description":"A successful Test or Live response.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The locator, cursor, or query is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The API key is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Live billing does not permit this request.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource is private or workspace API access is security-suspended.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource does not exist.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer accepts this cursor. Restart pagination from the first page.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer serves this data. Retrying fails the same way.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request rate limit was exceeded.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"451":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The owner of this profile asked Openhandle not to serve it.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request failed internally.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The service is temporarily unavailable.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}}},"security":[{"OpenhandleKey":[]}],"summary":"List post reposters","tags":["Twitter","Profile"],"x-openhandle-operation":"twitter.post.reposters.list","x-openhandle-sdk":{"operation":"list","paginated":true,"path":"twitter.post.reposters.list","scope":[{"name":"twitter"},{"name":"post","parameter":"identifier","reference":"post"},{"name":"reposters"}]},"x-openhandle-test-data":{"catalogUrl":"/v1/test-data?operation=twitter.post.reposters.list","contentHash":"sha256:7794275e0d6f248bb315a82bf631385a86ae70d2957dd815951fce7615602735","datasetVersion":"2026-10-27.2","example":{"identifier":"940100000000000001"}}}},"/v1/twitter/profiles/{identifier}":{"get":{"description":"Return one public profile. Use @username or a platform ID as the identifier. Test and Live use the same route, parameters, response schema, pagination, and errors. In Test, null means unavailable, not zero.","operationId":"twitterProfileGet","parameters":[{"description":"Public resource reference. Profile paths accept a username with an @ prefix, such as @openai, or the stable platform ID. Post paths accept the platform post ID or shortcode.","example":"@copperfield_lab_x_test","in":"path","name":"identifier","required":true,"schema":{"minLength":1,"type":"string"}},{"description":"Maximum accepted data age. The default is 24h.","example":"24h","in":"query","name":"freshness","required":false,"schema":{"default":"24h","enum":["live","24h","7d","30d"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/SuccessEnvelope"},{"properties":{"data":{"$ref":"#/components/schemas/TwitterProfile"}},"required":["data"],"type":"object"}]}}},"description":"A successful Test or Live response.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The locator, cursor, or query is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The API key is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Live billing does not permit this request.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource is private or workspace API access is security-suspended.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource does not exist.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer serves this data. Retrying fails the same way.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request rate limit was exceeded.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"451":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The owner of this profile asked Openhandle not to serve it.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request failed internally.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The service is temporarily unavailable.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}}},"security":[{"OpenhandleKey":[]}],"summary":"Get a profile","tags":["Twitter","Profile"],"x-openhandle-operation":"twitter.profile.get","x-openhandle-sdk":{"operation":"get","paginated":false,"path":"twitter.profile.get","scope":[{"name":"twitter"},{"name":"profile","parameter":"identifier","reference":"profile"}]},"x-openhandle-test-data":{"catalogUrl":"/v1/test-data?operation=twitter.profile.get","contentHash":"sha256:7794275e0d6f248bb315a82bf631385a86ae70d2957dd815951fce7615602735","datasetVersion":"2026-10-27.2","example":{"identifier":"@copperfield_lab_x_test"}}}},"/v1/twitter/profiles/{identifier}/followers":{"get":{"description":"Return a cursor-paginated collection of Twitter profiles. Test and Live use the same route, parameters, response schema, pagination, and errors. In Test, null means unavailable, not zero.","operationId":"twitterProfileFollowersList","parameters":[{"description":"Public resource reference. Profile paths accept a username with an @ prefix, such as @openai, or the stable platform ID. Post paths accept the platform post ID or shortcode.","example":"@copperfield_lab_x_test","in":"path","name":"identifier","required":true,"schema":{"minLength":1,"type":"string"}},{"description":"Maximum accepted data age. The default is 24h.","example":"24h","in":"query","name":"freshness","required":false,"schema":{"default":"24h","enum":["live","24h","7d","30d"],"type":"string"}},{"description":"Opaque cursor returned by the previous page.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/SuccessEnvelope"},{"properties":{"data":{"items":{"$ref":"#/components/schemas/TwitterProfile"},"type":"array"}},"required":["data","meta"],"type":"object"}]}}},"description":"A successful Test or Live response.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The locator, cursor, or query is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The API key is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Live billing does not permit this request.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource is private or workspace API access is security-suspended.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource does not exist.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer accepts this cursor. Restart pagination from the first page.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer serves this data. Retrying fails the same way.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request rate limit was exceeded.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"451":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The owner of this profile asked Openhandle not to serve it.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request failed internally.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The service is temporarily unavailable.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}}},"security":[{"OpenhandleKey":[]}],"summary":"List profile followers","tags":["Twitter","Profile"],"x-openhandle-operation":"twitter.profile.followers.list","x-openhandle-sdk":{"operation":"list","paginated":true,"path":"twitter.profile.followers.list","scope":[{"name":"twitter"},{"name":"profile","parameter":"identifier","reference":"profile"},{"name":"followers"}]},"x-openhandle-test-data":{"catalogUrl":"/v1/test-data?operation=twitter.profile.followers.list","contentHash":"sha256:7794275e0d6f248bb315a82bf631385a86ae70d2957dd815951fce7615602735","datasetVersion":"2026-10-27.2","example":{"identifier":"@copperfield_lab_x_test"}}}},"/v1/twitter/profiles/{identifier}/following":{"get":{"description":"Return a cursor-paginated collection of Twitter profiles. Test and Live use the same route, parameters, response schema, pagination, and errors. In Test, null means unavailable, not zero.","operationId":"twitterProfileFollowingList","parameters":[{"description":"Public resource reference. Profile paths accept a username with an @ prefix, such as @openai, or the stable platform ID. Post paths accept the platform post ID or shortcode.","example":"@copperfield_lab_x_test","in":"path","name":"identifier","required":true,"schema":{"minLength":1,"type":"string"}},{"description":"Maximum accepted data age. The default is 24h.","example":"24h","in":"query","name":"freshness","required":false,"schema":{"default":"24h","enum":["live","24h","7d","30d"],"type":"string"}},{"description":"Opaque cursor returned by the previous page.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/SuccessEnvelope"},{"properties":{"data":{"items":{"$ref":"#/components/schemas/TwitterProfile"},"type":"array"}},"required":["data","meta"],"type":"object"}]}}},"description":"A successful Test or Live response.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The locator, cursor, or query is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The API key is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Live billing does not permit this request.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource is private or workspace API access is security-suspended.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource does not exist.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer accepts this cursor. Restart pagination from the first page.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer serves this data. Retrying fails the same way.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request rate limit was exceeded.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"451":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The owner of this profile asked Openhandle not to serve it.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request failed internally.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The service is temporarily unavailable.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}}},"security":[{"OpenhandleKey":[]}],"summary":"List profile following","tags":["Twitter","Profile"],"x-openhandle-operation":"twitter.profile.following.list","x-openhandle-sdk":{"operation":"list","paginated":true,"path":"twitter.profile.following.list","scope":[{"name":"twitter"},{"name":"profile","parameter":"identifier","reference":"profile"},{"name":"following"}]},"x-openhandle-test-data":{"catalogUrl":"/v1/test-data?operation=twitter.profile.following.list","contentHash":"sha256:7794275e0d6f248bb315a82bf631385a86ae70d2957dd815951fce7615602735","datasetVersion":"2026-10-27.2","example":{"identifier":"@copperfield_lab_x_test"}}}},"/v1/twitter/profiles/{identifier}/media":{"get":{"description":"Return a cursor-paginated collection of a public Twitter profile's media. Test and Live use the same route, parameters, response schema, pagination, and errors. In Test, null means unavailable, not zero.","operationId":"twitterProfileMediaList","parameters":[{"description":"Public resource reference. Profile paths accept a username with an @ prefix, such as @openai, or the stable platform ID. Post paths accept the platform post ID or shortcode.","example":"@copperfield_lab_x_test","in":"path","name":"identifier","required":true,"schema":{"minLength":1,"type":"string"}},{"description":"Maximum accepted data age. The default is 24h.","example":"24h","in":"query","name":"freshness","required":false,"schema":{"default":"24h","enum":["live","24h","7d","30d"],"type":"string"}},{"description":"Opaque cursor returned by the previous page.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/SuccessEnvelope"},{"properties":{"data":{"items":{"$ref":"#/components/schemas/TwitterPost"},"type":"array"}},"required":["data","meta"],"type":"object"}]}}},"description":"A successful Test or Live response.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The locator, cursor, or query is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The API key is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Live billing does not permit this request.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource is private or workspace API access is security-suspended.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource does not exist.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer accepts this cursor. Restart pagination from the first page.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer serves this data. Retrying fails the same way.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request rate limit was exceeded.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"451":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The owner of this profile asked Openhandle not to serve it.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request failed internally.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The service is temporarily unavailable.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}}},"security":[{"OpenhandleKey":[]}],"summary":"List profile media","tags":["Twitter","Post"],"x-openhandle-operation":"twitter.profile.media.list","x-openhandle-sdk":{"operation":"list","paginated":true,"path":"twitter.profile.media.list","scope":[{"name":"twitter"},{"name":"profile","parameter":"identifier","reference":"profile"},{"name":"media"}]},"x-openhandle-test-data":{"catalogUrl":"/v1/test-data?operation=twitter.profile.media.list","contentHash":"sha256:7794275e0d6f248bb315a82bf631385a86ae70d2957dd815951fce7615602735","datasetVersion":"2026-10-27.2","example":{"identifier":"@copperfield_lab_x_test"}}}},"/v1/twitter/profiles/{identifier}/posts":{"get":{"description":"Return a stable page of posts for one public profile. Test and Live use the same route, parameters, response schema, pagination, and errors. In Test, null means unavailable, not zero.","operationId":"twitterProfilePostsList","parameters":[{"description":"Public resource reference. Profile paths accept a username with an @ prefix, such as @openai, or the stable platform ID. Post paths accept the platform post ID or shortcode.","example":"@copperfield_lab_x_test","in":"path","name":"identifier","required":true,"schema":{"minLength":1,"type":"string"}},{"description":"Maximum accepted data age. The default is 24h.","example":"24h","in":"query","name":"freshness","required":false,"schema":{"default":"24h","enum":["live","24h","7d","30d"],"type":"string"}},{"description":"Opaque cursor returned by the previous page.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}},{"description":"Return posts captured at or after this RFC 3339 timestamp.","in":"query","name":"since","required":false,"schema":{"format":"date-time","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/SuccessEnvelope"},{"properties":{"data":{"items":{"$ref":"#/components/schemas/TwitterPost"},"type":"array"}},"required":["data","meta"],"type":"object"}]}}},"description":"A successful Test or Live response.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The locator, cursor, or query is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The API key is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Live billing does not permit this request.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource is private or workspace API access is security-suspended.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource does not exist.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer accepts this cursor. Restart pagination from the first page.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer serves this data. Retrying fails the same way.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request rate limit was exceeded.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"451":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The owner of this profile asked Openhandle not to serve it.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request failed internally.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The service is temporarily unavailable.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}}},"security":[{"OpenhandleKey":[]}],"summary":"List profile posts","tags":["Twitter","Profile"],"x-openhandle-operation":"twitter.profile.posts.list","x-openhandle-sdk":{"operation":"list","paginated":true,"path":"twitter.profile.posts.list","scope":[{"name":"twitter"},{"name":"profile","parameter":"identifier","reference":"profile"},{"name":"posts"}]},"x-openhandle-test-data":{"catalogUrl":"/v1/test-data?operation=twitter.profile.posts.list","contentHash":"sha256:7794275e0d6f248bb315a82bf631385a86ae70d2957dd815951fce7615602735","datasetVersion":"2026-10-27.2","example":{"identifier":"@copperfield_lab_x_test"}}}},"/v1/twitter/profiles/{identifier}/replies":{"get":{"description":"Return a cursor-paginated collection of a public Twitter profile's replies. Test and Live use the same route, parameters, response schema, pagination, and errors. In Test, null means unavailable, not zero.","operationId":"twitterProfileRepliesList","parameters":[{"description":"Public resource reference. Profile paths accept a username with an @ prefix, such as @openai, or the stable platform ID. Post paths accept the platform post ID or shortcode.","example":"@copperfield_lab_x_test","in":"path","name":"identifier","required":true,"schema":{"minLength":1,"type":"string"}},{"description":"Maximum accepted data age. The default is 24h.","example":"24h","in":"query","name":"freshness","required":false,"schema":{"default":"24h","enum":["live","24h","7d","30d"],"type":"string"}},{"description":"Opaque cursor returned by the previous page.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/SuccessEnvelope"},{"properties":{"data":{"items":{"$ref":"#/components/schemas/TwitterPost"},"type":"array"}},"required":["data","meta"],"type":"object"}]}}},"description":"A successful Test or Live response.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The locator, cursor, or query is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The API key is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Live billing does not permit this request.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource is private or workspace API access is security-suspended.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource does not exist.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer accepts this cursor. Restart pagination from the first page.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer serves this data. Retrying fails the same way.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request rate limit was exceeded.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"451":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The owner of this profile asked Openhandle not to serve it.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request failed internally.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The service is temporarily unavailable.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}}},"security":[{"OpenhandleKey":[]}],"summary":"List profile replies","tags":["Twitter","Post"],"x-openhandle-operation":"twitter.profile.replies.list","x-openhandle-sdk":{"operation":"list","paginated":true,"path":"twitter.profile.replies.list","scope":[{"name":"twitter"},{"name":"profile","parameter":"identifier","reference":"profile"},{"name":"replies"}]},"x-openhandle-test-data":{"catalogUrl":"/v1/test-data?operation=twitter.profile.replies.list","contentHash":"sha256:7794275e0d6f248bb315a82bf631385a86ae70d2957dd815951fce7615602735","datasetVersion":"2026-10-27.2","example":{"identifier":"@copperfield_lab_x_test"}}}},"/v1/twitter/search/media":{"get":{"description":"Search public Twitter media with cursor pagination. Test and Live use the same route, parameters, response schema, pagination, and errors. In Test, null means unavailable, not zero.","operationId":"twitterSearchMedia","parameters":[{"description":"Public search query.","example":"synthetic","in":"query","name":"q","required":true,"schema":{"minLength":1,"type":"string"}},{"description":"Media type filter.","example":"image","in":"query","name":"type","required":true,"schema":{"enum":["image","video"],"type":"string"}},{"description":"Maximum accepted data age. The default is 24h.","example":"24h","in":"query","name":"freshness","required":false,"schema":{"default":"24h","enum":["live","24h","7d","30d"],"type":"string"}},{"description":"Opaque cursor returned by the previous page.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/SuccessEnvelope"},{"properties":{"data":{"items":{"$ref":"#/components/schemas/TwitterPost"},"type":"array"}},"required":["data","meta"],"type":"object"}]}}},"description":"A successful Test or Live response.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The locator, cursor, or query is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The API key is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Live billing does not permit this request.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource is private or workspace API access is security-suspended.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource does not exist.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer accepts this cursor. Restart pagination from the first page.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer serves this data. Retrying fails the same way.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request rate limit was exceeded.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"451":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The owner of this profile asked Openhandle not to serve it.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request failed internally.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The service is temporarily unavailable.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}}},"security":[{"OpenhandleKey":[]}],"summary":"Search Twitter media","tags":["Twitter","Post"],"x-openhandle-operation":"twitter.search.media.list","x-openhandle-sdk":{"operation":"list","paginated":true,"path":"twitter.search.media.list","scope":[{"name":"twitter"},{"name":"search"},{"name":"media"}]},"x-openhandle-test-data":{"catalogUrl":"/v1/test-data?operation=twitter.search.media.list","contentHash":"sha256:7794275e0d6f248bb315a82bf631385a86ae70d2957dd815951fce7615602735","datasetVersion":"2026-10-27.2","example":{"query":"synthetic"}}}},"/v1/twitter/search/posts":{"get":{"description":"Search public Twitter posts with cursor pagination. Test and Live use the same route, parameters, response schema, pagination, and errors. In Test, null means unavailable, not zero.","operationId":"twitterSearchPosts","parameters":[{"description":"Public search query.","example":"synthetic","in":"query","name":"q","required":true,"schema":{"minLength":1,"type":"string"}},{"description":"Result ordering for this operation.","example":"latest","in":"query","name":"sort","required":false,"schema":{"default":"latest","enum":["latest","top"],"type":"string"}},{"description":"Maximum accepted data age. The default is 24h.","example":"24h","in":"query","name":"freshness","required":false,"schema":{"default":"24h","enum":["live","24h","7d","30d"],"type":"string"}},{"description":"Opaque cursor returned by the previous page.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/SuccessEnvelope"},{"properties":{"data":{"items":{"$ref":"#/components/schemas/TwitterPost"},"type":"array"}},"required":["data","meta"],"type":"object"}]}}},"description":"A successful Test or Live response.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The locator, cursor, or query is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The API key is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Live billing does not permit this request.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource is private or workspace API access is security-suspended.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource does not exist.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer accepts this cursor. Restart pagination from the first page.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer serves this data. Retrying fails the same way.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request rate limit was exceeded.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"451":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The owner of this profile asked Openhandle not to serve it.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request failed internally.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The service is temporarily unavailable.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}}},"security":[{"OpenhandleKey":[]}],"summary":"Search Twitter posts","tags":["Twitter","Post"],"x-openhandle-operation":"twitter.search.posts.list","x-openhandle-sdk":{"operation":"list","paginated":true,"path":"twitter.search.posts.list","scope":[{"name":"twitter"},{"name":"search"},{"name":"posts"}]},"x-openhandle-test-data":{"catalogUrl":"/v1/test-data?operation=twitter.search.posts.list","contentHash":"sha256:7794275e0d6f248bb315a82bf631385a86ae70d2957dd815951fce7615602735","datasetVersion":"2026-10-27.2","example":{"query":"synthetic"}}}},"/v1/twitter/search/suggestions":{"get":{"description":"Search suggestions from public Twitter data. Test and Live use the same route, parameters, response schema, pagination, and errors. In Test, null means unavailable, not zero.","operationId":"Twitter_search_suggestions_list","parameters":[{"description":"Public search query.","example":"synthetic","in":"query","name":"q","required":true,"schema":{"minLength":1,"type":"string"}},{"description":"Maximum accepted data age. The default is 24h.","example":"24h","in":"query","name":"freshness","required":false,"schema":{"default":"24h","enum":["live","24h","7d","30d"],"type":"string"}},{"description":"Opaque cursor returned by the previous page.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/SuccessEnvelope"},{"properties":{"data":{"items":{"$ref":"#/components/schemas/TwitterProfile"},"type":"array"}},"required":["data","meta"],"type":"object"}]}}},"description":"A successful Test or Live response.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The locator, cursor, or query is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The API key is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Live billing does not permit this request.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource is private or workspace API access is security-suspended.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource does not exist.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer accepts this cursor. Restart pagination from the first page.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer serves this data. Retrying fails the same way.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request rate limit was exceeded.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"451":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The owner of this profile asked Openhandle not to serve it.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request failed internally.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The service is temporarily unavailable.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}}},"security":[{"OpenhandleKey":[]}],"summary":"Search suggestions","tags":["Twitter","Entity"],"x-openhandle-operation":"twitter.search.suggestions.list","x-openhandle-sdk":{"operation":"list","paginated":true,"path":"twitter.search.suggestions.list","scope":[{"name":"twitter"},{"name":"search"},{"name":"suggestions"}]},"x-openhandle-test-data":{"catalogUrl":"/v1/test-data?operation=twitter.search.suggestions.list","contentHash":"sha256:7794275e0d6f248bb315a82bf631385a86ae70d2957dd815951fce7615602735","datasetVersion":"2026-10-27.2","example":{"query":"synthetic"}}}},"/v1/twitter/search/users":{"get":{"description":"Search public Twitter users with cursor pagination. Test and Live use the same route, parameters, response schema, pagination, and errors. In Test, null means unavailable, not zero.","operationId":"twitterSearchUsers","parameters":[{"description":"Public search query.","example":"synthetic","in":"query","name":"q","required":true,"schema":{"minLength":1,"type":"string"}},{"description":"Maximum accepted data age. The default is 24h.","example":"24h","in":"query","name":"freshness","required":false,"schema":{"default":"24h","enum":["live","24h","7d","30d"],"type":"string"}},{"description":"Opaque cursor returned by the previous page.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/SuccessEnvelope"},{"properties":{"data":{"items":{"$ref":"#/components/schemas/TwitterProfile"},"type":"array"}},"required":["data","meta"],"type":"object"}]}}},"description":"A successful Test or Live response.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The locator, cursor, or query is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The API key is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Live billing does not permit this request.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource is private or workspace API access is security-suspended.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource does not exist.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer accepts this cursor. Restart pagination from the first page.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer serves this data. Retrying fails the same way.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request rate limit was exceeded.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"451":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The owner of this profile asked Openhandle not to serve it.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request failed internally.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The service is temporarily unavailable.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}}},"security":[{"OpenhandleKey":[]}],"summary":"Search Twitter users","tags":["Twitter","Profile"],"x-openhandle-operation":"twitter.search.users.list","x-openhandle-sdk":{"operation":"list","paginated":true,"path":"twitter.search.users.list","scope":[{"name":"twitter"},{"name":"search"},{"name":"users"}]},"x-openhandle-test-data":{"catalogUrl":"/v1/test-data?operation=twitter.search.users.list","contentHash":"sha256:7794275e0d6f248bb315a82bf631385a86ae70d2957dd815951fce7615602735","datasetVersion":"2026-10-27.2","example":{"query":"synthetic"}}}},"/v1/urls/fetch":{"post":{"description":"Parse a supported social URL locally, then return the same typed resource as its canonical Openhandle operation. TikTok short links such as tiktok.com/t/… and vm.tiktok.com/… are expanded through their redirect first. The underlying data read is metered once.","operationId":"fetchSocialURL","requestBody":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"freshness":{"default":"24h","enum":["live","24h","7d","30d"],"type":"string"},"url":{"description":"Supported social URL, with or without an https:// scheme.","minLength":1,"type":"string"}},"required":["url"],"type":"object"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"oneOf":[{"allOf":[{"$ref":"#/components/schemas/SuccessEnvelope"},{"properties":{"data":{"$ref":"#/components/schemas/InstagramProfile"},"platform":{"const":"instagram"},"resource":{"const":"profile"}},"required":["platform","resource","data"],"type":"object"}]},{"allOf":[{"$ref":"#/components/schemas/SuccessEnvelope"},{"properties":{"data":{"$ref":"#/components/schemas/InstagramPost"},"platform":{"const":"instagram"},"resource":{"const":"post"}},"required":["platform","resource","data"],"type":"object"}]},{"allOf":[{"$ref":"#/components/schemas/SuccessEnvelope"},{"properties":{"data":{"$ref":"#/components/schemas/InstagramStory"},"platform":{"const":"instagram"},"resource":{"const":"story"}},"required":["platform","resource","data"],"type":"object"}]},{"allOf":[{"$ref":"#/components/schemas/SuccessEnvelope"},{"properties":{"data":{"$ref":"#/components/schemas/InstagramHighlight"},"platform":{"const":"instagram"},"resource":{"const":"highlight"}},"required":["platform","resource","data"],"type":"object"}]},{"allOf":[{"$ref":"#/components/schemas/SuccessEnvelope"},{"properties":{"data":{"$ref":"#/components/schemas/TikTokProfile"},"platform":{"const":"tiktok"},"resource":{"const":"profile"}},"required":["platform","resource","data"],"type":"object"}]},{"allOf":[{"$ref":"#/components/schemas/SuccessEnvelope"},{"properties":{"data":{"$ref":"#/components/schemas/TikTokPost"},"platform":{"const":"tiktok"},"resource":{"const":"post"}},"required":["platform","resource","data"],"type":"object"}]},{"allOf":[{"$ref":"#/components/schemas/SuccessEnvelope"},{"properties":{"data":{"$ref":"#/components/schemas/TwitterProfile"},"platform":{"const":"twitter"},"resource":{"const":"profile"}},"required":["platform","resource","data"],"type":"object"}]},{"allOf":[{"$ref":"#/components/schemas/SuccessEnvelope"},{"properties":{"data":{"$ref":"#/components/schemas/TwitterPost"},"platform":{"const":"twitter"},"resource":{"const":"post"}},"required":["platform","resource","data"],"type":"object"}]},{"allOf":[{"$ref":"#/components/schemas/SuccessEnvelope"},{"properties":{"data":{"$ref":"#/components/schemas/RedditProfile"},"platform":{"const":"reddit"},"resource":{"const":"profile"}},"required":["platform","resource","data"],"type":"object"}]},{"allOf":[{"$ref":"#/components/schemas/SuccessEnvelope"},{"properties":{"data":{"$ref":"#/components/schemas/RedditPost"},"platform":{"const":"reddit"},"resource":{"const":"post"}},"required":["platform","resource","data"],"type":"object"}]},{"allOf":[{"$ref":"#/components/schemas/SuccessEnvelope"},{"properties":{"data":{"$ref":"#/components/schemas/RedditSubreddit"},"platform":{"const":"reddit"},"resource":{"const":"subreddit"}},"required":["platform","resource","data"],"type":"object"}]},{"allOf":[{"$ref":"#/components/schemas/SuccessEnvelope"},{"properties":{"data":{"$ref":"#/components/schemas/YouTubeProfile"},"platform":{"const":"youtube"},"resource":{"const":"profile"}},"required":["platform","resource","data"],"type":"object"}]},{"allOf":[{"$ref":"#/components/schemas/SuccessEnvelope"},{"properties":{"data":{"$ref":"#/components/schemas/YouTubePost"},"platform":{"const":"youtube"},"resource":{"const":"post"}},"required":["platform","resource","data"],"type":"object"}]}]}}},"description":"The typed profile, post, story, or highlight represented by the URL.","headers":{"Content-Location":{"description":"Canonical Openhandle path for the resolved resource.","schema":{"type":"string"}},"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The locator, cursor, or query is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The API key is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Live billing does not permit this request.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource is private or workspace API access is security-suspended.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource does not exist.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer serves this data. Retrying fails the same way.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request rate limit was exceeded.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"451":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The owner of this profile asked Openhandle not to serve it.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request failed internally.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The service is temporarily unavailable.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}}},"security":[{"OpenhandleKey":[]}],"summary":"Fetch the resource at a social URL","tags":["Utilities"],"x-openhandle-metered":true,"x-openhandle-sdk":{"operation":"fetch","paginated":false,"path":"fetch","scope":[]}}},"/v1/youtube/charts/artists":{"get":{"description":"Return the weekly top artists chart of one country. Test and Live use the same route, parameters, response schema, pagination, and errors. In Test, null means unavailable, not zero.","operationId":"Youtube_charts_artists_list","parameters":[{"description":"Two-letter ISO 3166 country code. The default is US.","in":"query","name":"country","required":false,"schema":{"minLength":1,"type":"string"}},{"description":"Maximum accepted data age. The default is 24h.","example":"24h","in":"query","name":"freshness","required":false,"schema":{"default":"24h","enum":["live","24h","7d","30d"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/SuccessEnvelope"},{"properties":{"data":{"items":{"$ref":"#/components/schemas/YouTubeChartEntry"},"type":"array"}},"required":["data"],"type":"object"}]}}},"description":"A successful Test or Live response.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The locator, cursor, or query is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The API key is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Live billing does not permit this request.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource is private or workspace API access is security-suspended.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource does not exist.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer serves this data. Retrying fails the same way.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request rate limit was exceeded.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"451":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The owner of this profile asked Openhandle not to serve it.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request failed internally.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The service is temporarily unavailable.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}}},"security":[{"OpenhandleKey":[]}],"summary":"List top artists","tags":["YouTube","Chart"],"x-openhandle-operation":"youtube.charts.artists.list","x-openhandle-sdk":{"operation":"list","paginated":false,"path":"youtube.charts.artists.list","scope":[{"name":"youtube"},{"name":"charts"},{"name":"artists"}]},"x-openhandle-test-data":{"catalogUrl":"/v1/test-data?operation=youtube.charts.artists.list","contentHash":"sha256:7794275e0d6f248bb315a82bf631385a86ae70d2957dd815951fce7615602735","datasetVersion":"2026-10-27.2","example":{"id":"","q":"","query":""}}}},"/v1/youtube/charts/tracks":{"get":{"description":"Return the weekly top songs chart of one country. Test and Live use the same route, parameters, response schema, pagination, and errors. In Test, null means unavailable, not zero.","operationId":"Youtube_charts_tracks_list","parameters":[{"description":"Two-letter ISO 3166 country code. The default is US.","in":"query","name":"country","required":false,"schema":{"minLength":1,"type":"string"}},{"description":"Maximum accepted data age. The default is 24h.","example":"24h","in":"query","name":"freshness","required":false,"schema":{"default":"24h","enum":["live","24h","7d","30d"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/SuccessEnvelope"},{"properties":{"data":{"items":{"$ref":"#/components/schemas/YouTubeChartEntry"},"type":"array"}},"required":["data"],"type":"object"}]}}},"description":"A successful Test or Live response.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The locator, cursor, or query is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The API key is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Live billing does not permit this request.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource is private or workspace API access is security-suspended.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource does not exist.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer serves this data. Retrying fails the same way.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request rate limit was exceeded.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"451":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The owner of this profile asked Openhandle not to serve it.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request failed internally.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The service is temporarily unavailable.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}}},"security":[{"OpenhandleKey":[]}],"summary":"List top songs","tags":["YouTube","Chart"],"x-openhandle-operation":"youtube.charts.tracks.list","x-openhandle-sdk":{"operation":"list","paginated":false,"path":"youtube.charts.tracks.list","scope":[{"name":"youtube"},{"name":"charts"},{"name":"tracks"}]},"x-openhandle-test-data":{"catalogUrl":"/v1/test-data?operation=youtube.charts.tracks.list","contentHash":"sha256:7794275e0d6f248bb315a82bf631385a86ae70d2957dd815951fce7615602735","datasetVersion":"2026-10-27.2","example":{"id":"","q":"","query":""}}}},"/v1/youtube/charts/videos":{"get":{"description":"Return the weekly top music videos chart of one country. Test and Live use the same route, parameters, response schema, pagination, and errors. In Test, null means unavailable, not zero.","operationId":"Youtube_charts_videos_list","parameters":[{"description":"Two-letter ISO 3166 country code. The default is US.","in":"query","name":"country","required":false,"schema":{"minLength":1,"type":"string"}},{"description":"Maximum accepted data age. The default is 24h.","example":"24h","in":"query","name":"freshness","required":false,"schema":{"default":"24h","enum":["live","24h","7d","30d"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/SuccessEnvelope"},{"properties":{"data":{"items":{"$ref":"#/components/schemas/YouTubeChartEntry"},"type":"array"}},"required":["data"],"type":"object"}]}}},"description":"A successful Test or Live response.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The locator, cursor, or query is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The API key is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Live billing does not permit this request.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource is private or workspace API access is security-suspended.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource does not exist.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer serves this data. Retrying fails the same way.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request rate limit was exceeded.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"451":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The owner of this profile asked Openhandle not to serve it.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request failed internally.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The service is temporarily unavailable.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}}},"security":[{"OpenhandleKey":[]}],"summary":"List top music videos","tags":["YouTube","Chart"],"x-openhandle-operation":"youtube.charts.videos.list","x-openhandle-sdk":{"operation":"list","paginated":false,"path":"youtube.charts.videos.list","scope":[{"name":"youtube"},{"name":"charts"},{"name":"videos"}]},"x-openhandle-test-data":{"catalogUrl":"/v1/test-data?operation=youtube.charts.videos.list","contentHash":"sha256:7794275e0d6f248bb315a82bf631385a86ae70d2957dd815951fce7615602735","datasetVersion":"2026-10-27.2","example":{"id":"","q":"","query":""}}}},"/v1/youtube/community-posts/{identifier}":{"get":{"description":"Return one public YouTube community post. Test and Live use the same route, parameters, response schema, pagination, and errors. In Test, null means unavailable, not zero.","operationId":"Youtube_community_post_get","parameters":[{"description":"Public resource reference. Profile paths accept a username with an @ prefix, such as @openai, or the stable platform ID. Post paths accept the platform post ID or shortcode.","example":"Ugsynthpost001","in":"path","name":"identifier","required":true,"schema":{"minLength":1,"type":"string"}},{"description":"Maximum accepted data age. The default is 24h.","example":"24h","in":"query","name":"freshness","required":false,"schema":{"default":"24h","enum":["live","24h","7d","30d"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/SuccessEnvelope"},{"properties":{"data":{"$ref":"#/components/schemas/YouTubeCommunityPost"}},"required":["data"],"type":"object"}]}}},"description":"A successful Test or Live response.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The locator, cursor, or query is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The API key is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Live billing does not permit this request.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource is private or workspace API access is security-suspended.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource does not exist.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer serves this data. Retrying fails the same way.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request rate limit was exceeded.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"451":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The owner of this profile asked Openhandle not to serve it.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request failed internally.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The service is temporarily unavailable.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}}},"security":[{"OpenhandleKey":[]}],"summary":"Get a community post","tags":["YouTube","Post"],"x-openhandle-operation":"youtube.community.post.get","x-openhandle-sdk":{"operation":"get","paginated":false,"path":"youtube.communityPost.get","scope":[{"name":"youtube"},{"name":"communityPost","parameter":"identifier","reference":"communityPost"}]},"x-openhandle-test-data":{"catalogUrl":"/v1/test-data?operation=youtube.community.post.get","contentHash":"sha256:7794275e0d6f248bb315a82bf631385a86ae70d2957dd815951fce7615602735","datasetVersion":"2026-10-27.2","example":{"identifier":"Ugsynthpost001"}}}},"/v1/youtube/community-posts/{identifier}/comments":{"get":{"description":"Return the comments of a public YouTube community post. Test and Live use the same route, parameters, response schema, pagination, and errors. In Test, null means unavailable, not zero.","operationId":"Youtube_community_post_comments_list","parameters":[{"description":"Public resource reference. Profile paths accept a username with an @ prefix, such as @openai, or the stable platform ID. Post paths accept the platform post ID or shortcode.","example":"Ugsynthpost001","in":"path","name":"identifier","required":true,"schema":{"minLength":1,"type":"string"}},{"description":"Result ordering for this operation.","example":"top","in":"query","name":"sort","required":false,"schema":{"default":"top","enum":["top","newest"],"type":"string"}},{"description":"Maximum accepted data age. The default is 24h.","example":"24h","in":"query","name":"freshness","required":false,"schema":{"default":"24h","enum":["live","24h","7d","30d"],"type":"string"}},{"description":"Opaque cursor returned by the previous page.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/SuccessEnvelope"},{"properties":{"data":{"items":{"$ref":"#/components/schemas/YouTubeComment"},"type":"array"}},"required":["data","meta"],"type":"object"}]}}},"description":"A successful Test or Live response.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The locator, cursor, or query is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The API key is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Live billing does not permit this request.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource is private or workspace API access is security-suspended.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource does not exist.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer accepts this cursor. Restart pagination from the first page.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer serves this data. Retrying fails the same way.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request rate limit was exceeded.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"451":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The owner of this profile asked Openhandle not to serve it.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request failed internally.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The service is temporarily unavailable.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}}},"security":[{"OpenhandleKey":[]}],"summary":"List community post comments","tags":["YouTube","Comment"],"x-openhandle-operation":"youtube.community.post.comments.list","x-openhandle-sdk":{"operation":"list","paginated":true,"path":"youtube.communityPost.comments.list","scope":[{"name":"youtube"},{"name":"communityPost","parameter":"identifier","reference":"communityPost"},{"name":"comments"}]},"x-openhandle-test-data":{"catalogUrl":"/v1/test-data?operation=youtube.community.post.comments.list","contentHash":"sha256:7794275e0d6f248bb315a82bf631385a86ae70d2957dd815951fce7615602735","datasetVersion":"2026-10-27.2","example":{"identifier":"Ugsynthpost001"}}}},"/v1/youtube/hashtags/{identifier}/posts":{"get":{"description":"Return the public YouTube videos and Shorts of one hashtag. Test and Live use the same route, parameters, response schema, pagination, and errors. In Test, null means unavailable, not zero.","operationId":"Youtube_hashtag_posts_list","parameters":[{"description":"Public resource reference. Profile paths accept a username with an @ prefix, such as @openai, or the stable platform ID. Post paths accept the platform post ID or shortcode.","example":"synthetic","in":"path","name":"identifier","required":true,"schema":{"minLength":1,"type":"string"}},{"description":"Maximum accepted data age. The default is 24h.","example":"24h","in":"query","name":"freshness","required":false,"schema":{"default":"24h","enum":["live","24h","7d","30d"],"type":"string"}},{"description":"Opaque cursor returned by the previous page.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/SuccessEnvelope"},{"properties":{"data":{"items":{"$ref":"#/components/schemas/YouTubePost"},"type":"array"}},"required":["data","meta"],"type":"object"}]}}},"description":"A successful Test or Live response.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The locator, cursor, or query is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The API key is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Live billing does not permit this request.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource is private or workspace API access is security-suspended.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource does not exist.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer accepts this cursor. Restart pagination from the first page.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer serves this data. Retrying fails the same way.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request rate limit was exceeded.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"451":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The owner of this profile asked Openhandle not to serve it.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request failed internally.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The service is temporarily unavailable.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}}},"security":[{"OpenhandleKey":[]}],"summary":"List hashtag posts","tags":["YouTube","Post"],"x-openhandle-operation":"youtube.hashtag.posts.list","x-openhandle-sdk":{"operation":"list","paginated":true,"path":"youtube.hashtag.posts.list","scope":[{"name":"youtube"},{"name":"hashtag","parameter":"identifier","reference":"hashtag"},{"name":"posts"}]},"x-openhandle-test-data":{"catalogUrl":"/v1/test-data?operation=youtube.hashtag.posts.list","contentHash":"sha256:7794275e0d6f248bb315a82bf631385a86ae70d2957dd815951fce7615602735","datasetVersion":"2026-10-27.2","example":{"identifier":"synthetic"}}}},"/v1/youtube/playlists/{identifier}/posts":{"get":{"description":"Return the videos of a public YouTube playlist. Test and Live use the same route, parameters, response schema, pagination, and errors. In Test, null means unavailable, not zero.","operationId":"Youtube_playlist_posts_list","parameters":[{"description":"Public resource reference. Profile paths accept a username with an @ prefix, such as @openai, or the stable platform ID. Post paths accept the platform post ID or shortcode.","example":"PLsynthetic001","in":"path","name":"identifier","required":true,"schema":{"minLength":1,"type":"string"}},{"description":"Maximum accepted data age. The default is 24h.","example":"24h","in":"query","name":"freshness","required":false,"schema":{"default":"24h","enum":["live","24h","7d","30d"],"type":"string"}},{"description":"Opaque cursor returned by the previous page.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/SuccessEnvelope"},{"properties":{"data":{"items":{"$ref":"#/components/schemas/YouTubePost"},"type":"array"}},"required":["data","meta"],"type":"object"}]}}},"description":"A successful Test or Live response.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The locator, cursor, or query is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The API key is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Live billing does not permit this request.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource is private or workspace API access is security-suspended.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource does not exist.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer accepts this cursor. Restart pagination from the first page.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer serves this data. Retrying fails the same way.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request rate limit was exceeded.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"451":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The owner of this profile asked Openhandle not to serve it.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request failed internally.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The service is temporarily unavailable.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}}},"security":[{"OpenhandleKey":[]}],"summary":"List playlist posts","tags":["YouTube","Post"],"x-openhandle-operation":"youtube.playlist.posts.list","x-openhandle-sdk":{"operation":"list","paginated":true,"path":"youtube.playlist.posts.list","scope":[{"name":"youtube"},{"name":"playlist","parameter":"identifier","reference":"playlist"},{"name":"posts"}]},"x-openhandle-test-data":{"catalogUrl":"/v1/test-data?operation=youtube.playlist.posts.list","contentHash":"sha256:7794275e0d6f248bb315a82bf631385a86ae70d2957dd815951fce7615602735","datasetVersion":"2026-10-27.2","example":{"identifier":"PLsynthetic001"}}}},"/v1/youtube/posts/{identifier}":{"get":{"description":"Return one public YouTube video, Short, or livestream with its exact counts and publication time. Test and Live use the same route, parameters, response schema, pagination, and errors. In Test, null means unavailable, not zero.","operationId":"Youtube_post_get","parameters":[{"description":"Public resource reference. Profile paths accept a username with an @ prefix, such as @openai, or the stable platform ID. Post paths accept the platform post ID or shortcode.","example":"synthvid001","in":"path","name":"identifier","required":true,"schema":{"minLength":1,"type":"string"}},{"description":"Maximum accepted data age. The default is 24h.","example":"24h","in":"query","name":"freshness","required":false,"schema":{"default":"24h","enum":["live","24h","7d","30d"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/SuccessEnvelope"},{"properties":{"data":{"$ref":"#/components/schemas/YouTubePost"}},"required":["data"],"type":"object"}]}}},"description":"A successful Test or Live response.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The locator, cursor, or query is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The API key is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Live billing does not permit this request.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource is private or workspace API access is security-suspended.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource does not exist.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer serves this data. Retrying fails the same way.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request rate limit was exceeded.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"451":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The owner of this profile asked Openhandle not to serve it.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request failed internally.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The service is temporarily unavailable.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}}},"security":[{"OpenhandleKey":[]}],"summary":"Get a post","tags":["YouTube","Post"],"x-openhandle-operation":"youtube.post.get","x-openhandle-sdk":{"operation":"get","paginated":false,"path":"youtube.post.get","scope":[{"name":"youtube"},{"name":"post","parameter":"identifier","reference":"post"}]},"x-openhandle-test-data":{"catalogUrl":"/v1/test-data?operation=youtube.post.get","contentHash":"sha256:7794275e0d6f248bb315a82bf631385a86ae70d2957dd815951fce7615602735","datasetVersion":"2026-10-27.2","example":{"identifier":"synthvid001"}}}},"/v1/youtube/posts/{identifier}/comments":{"get":{"description":"Return the top-level comments of a public YouTube video or Short. Test and Live use the same route, parameters, response schema, pagination, and errors. In Test, null means unavailable, not zero.","operationId":"Youtube_post_comments_list","parameters":[{"description":"Public resource reference. Profile paths accept a username with an @ prefix, such as @openai, or the stable platform ID. Post paths accept the platform post ID or shortcode.","example":"synthvid001","in":"path","name":"identifier","required":true,"schema":{"minLength":1,"type":"string"}},{"description":"Result ordering for this operation.","example":"top","in":"query","name":"sort","required":false,"schema":{"default":"top","enum":["top","newest"],"type":"string"}},{"description":"Maximum accepted data age. The default is 24h.","example":"24h","in":"query","name":"freshness","required":false,"schema":{"default":"24h","enum":["live","24h","7d","30d"],"type":"string"}},{"description":"Opaque cursor returned by the previous page.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/SuccessEnvelope"},{"properties":{"data":{"items":{"$ref":"#/components/schemas/YouTubeComment"},"type":"array"}},"required":["data","meta"],"type":"object"}]}}},"description":"A successful Test or Live response.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The locator, cursor, or query is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The API key is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Live billing does not permit this request.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource is private or workspace API access is security-suspended.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource does not exist.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer accepts this cursor. Restart pagination from the first page.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer serves this data. Retrying fails the same way.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request rate limit was exceeded.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"451":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The owner of this profile asked Openhandle not to serve it.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request failed internally.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The service is temporarily unavailable.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}}},"security":[{"OpenhandleKey":[]}],"summary":"List post comments","tags":["YouTube","Comment"],"x-openhandle-operation":"youtube.post.comments.list","x-openhandle-sdk":{"operation":"list","paginated":true,"path":"youtube.post.comments.list","scope":[{"name":"youtube"},{"name":"post","parameter":"identifier","reference":"post"},{"name":"comments"}]},"x-openhandle-test-data":{"catalogUrl":"/v1/test-data?operation=youtube.post.comments.list","contentHash":"sha256:7794275e0d6f248bb315a82bf631385a86ae70d2957dd815951fce7615602735","datasetVersion":"2026-10-27.2","example":{"identifier":"synthvid001"}}}},"/v1/youtube/posts/{identifier}/comments/{comment_id}/replies":{"get":{"description":"Return the replies of one YouTube comment. Pass the repliesToken that comment carried. Test and Live use the same route, parameters, response schema, pagination, and errors. In Test, null means unavailable, not zero.","operationId":"Youtube_post_comment_replies_list","parameters":[{"description":"Public resource reference. Profile paths accept a username with an @ prefix, such as @openai, or the stable platform ID. Post paths accept the platform post ID or shortcode.","example":"synthvid001","in":"path","name":"identifier","required":true,"schema":{"minLength":1,"type":"string"}},{"description":"Opaque native comment ID.","example":"Ugsynthcomment001","in":"path","name":"comment_id","required":true,"schema":{"minLength":1,"type":"string"}},{"description":"The repliesToken of the comment whose replies to read.","example":"synthetic-replies-Ugsynthcomment001","in":"query","name":"token","required":true,"schema":{"minLength":1,"type":"string"}},{"description":"Maximum accepted data age. The default is 24h.","example":"24h","in":"query","name":"freshness","required":false,"schema":{"default":"24h","enum":["live","24h","7d","30d"],"type":"string"}},{"description":"Opaque cursor returned by the previous page.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/SuccessEnvelope"},{"properties":{"data":{"items":{"$ref":"#/components/schemas/YouTubeComment"},"type":"array"}},"required":["data","meta"],"type":"object"}]}}},"description":"A successful Test or Live response.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The locator, cursor, or query is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The API key is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Live billing does not permit this request.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource is private or workspace API access is security-suspended.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource does not exist.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer accepts this cursor. Restart pagination from the first page.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer serves this data. Retrying fails the same way.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request rate limit was exceeded.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"451":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The owner of this profile asked Openhandle not to serve it.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request failed internally.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The service is temporarily unavailable.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}}},"security":[{"OpenhandleKey":[]}],"summary":"List comment replies","tags":["YouTube","Comment"],"x-openhandle-operation":"youtube.post.comment.replies.list","x-openhandle-sdk":{"operation":"list","paginated":true,"path":"youtube.post.comment.replies.list","scope":[{"name":"youtube"},{"name":"post","parameter":"identifier","reference":"post"},{"name":"comment","parameter":"comment_id","reference":"comment"},{"name":"replies"}]},"x-openhandle-test-data":{"catalogUrl":"/v1/test-data?operation=youtube.post.comment.replies.list","contentHash":"sha256:7794275e0d6f248bb315a82bf631385a86ae70d2957dd815951fce7615602735","datasetVersion":"2026-10-27.2","example":{"comment_id":"Ugsynthcomment001","identifier":"synthvid001","token":"synthetic-replies-Ugsynthcomment001"}}}},"/v1/youtube/posts/{identifier}/files":{"get":{"description":"Return the video and audio streams of a public YouTube video as download links. Openhandle refreshes the links, so they keep working. Test and Live use the same route, parameters, response schema, pagination, and errors. In Test, null means unavailable, not zero.","operationId":"Youtube_post_files_get","parameters":[{"description":"Public resource reference. Profile paths accept a username with an @ prefix, such as @openai, or the stable platform ID. Post paths accept the platform post ID or shortcode.","example":"synthvid001","in":"path","name":"identifier","required":true,"schema":{"minLength":1,"type":"string"}},{"description":"Maximum accepted data age. The default is 24h.","example":"24h","in":"query","name":"freshness","required":false,"schema":{"default":"24h","enum":["live","24h","7d","30d"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/SuccessEnvelope"},{"properties":{"data":{"$ref":"#/components/schemas/YouTubeFiles"}},"required":["data"],"type":"object"}]}}},"description":"A successful Test or Live response.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The locator, cursor, or query is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The API key is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Live billing does not permit this request.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource is private or workspace API access is security-suspended.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource does not exist.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer serves this data. Retrying fails the same way.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request rate limit was exceeded.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"451":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The owner of this profile asked Openhandle not to serve it.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request failed internally.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The service is temporarily unavailable.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}}},"security":[{"OpenhandleKey":[]}],"summary":"Get post files","tags":["YouTube","Files"],"x-openhandle-operation":"youtube.post.files.get","x-openhandle-sdk":{"operation":"get","paginated":false,"path":"youtube.post.files.get","scope":[{"name":"youtube"},{"name":"post","parameter":"identifier","reference":"post"},{"name":"files"}]},"x-openhandle-test-data":{"catalogUrl":"/v1/test-data?operation=youtube.post.files.get","contentHash":"sha256:7794275e0d6f248bb315a82bf631385a86ae70d2957dd815951fce7615602735","datasetVersion":"2026-10-27.2","example":{"identifier":"synthvid001"}}}},"/v1/youtube/posts/{identifier}/frame":{"get":{"description":"Return one still frame of a public video at a time in seconds, in every resolution the video has. Test and Live use the same route, parameters, response schema, pagination, and errors. In Test, null means unavailable, not zero.","operationId":"Youtube_post_frame_get","parameters":[{"description":"Public resource reference. Profile paths accept a username with an @ prefix, such as @openai, or the stable platform ID. Post paths accept the platform post ID or shortcode.","example":"synthvid001","in":"path","name":"identifier","required":true,"schema":{"minLength":1,"type":"string"}},{"description":"Time of the frame in whole seconds from the start of the video.","example":"43","in":"query","name":"at","required":true,"schema":{"maximum":359999,"minimum":0,"type":"integer"}},{"description":"Maximum accepted data age. The default is 24h.","example":"24h","in":"query","name":"freshness","required":false,"schema":{"default":"24h","enum":["live","24h","7d","30d"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/SuccessEnvelope"},{"properties":{"data":{"$ref":"#/components/schemas/YouTubeFrame"}},"required":["data"],"type":"object"}]}}},"description":"A successful Test or Live response.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The locator, cursor, or query is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The API key is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Live billing does not permit this request.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource is private or workspace API access is security-suspended.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource does not exist.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer serves this data. Retrying fails the same way.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request rate limit was exceeded.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"451":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The owner of this profile asked Openhandle not to serve it.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request failed internally.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The service is temporarily unavailable.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}}},"security":[{"OpenhandleKey":[]}],"summary":"Get post frame","tags":["YouTube","Frame"],"x-openhandle-operation":"youtube.post.frame.get","x-openhandle-sdk":{"operation":"get","paginated":false,"path":"youtube.post.frame.get","scope":[{"name":"youtube"},{"name":"post","parameter":"identifier","reference":"post"},{"name":"frame"}]},"x-openhandle-test-data":{"catalogUrl":"/v1/test-data?operation=youtube.post.frame.get","contentHash":"sha256:7794275e0d6f248bb315a82bf631385a86ae70d2957dd815951fce7615602735","datasetVersion":"2026-10-27.2","example":{"at":"43","identifier":"synthvid001"}}}},"/v1/youtube/posts/{identifier}/related":{"get":{"description":"Return the videos YouTube suggests next to a public video. Test and Live use the same route, parameters, response schema, pagination, and errors. In Test, null means unavailable, not zero.","operationId":"Youtube_post_related_list","parameters":[{"description":"Public resource reference. Profile paths accept a username with an @ prefix, such as @openai, or the stable platform ID. Post paths accept the platform post ID or shortcode.","example":"synthvid001","in":"path","name":"identifier","required":true,"schema":{"minLength":1,"type":"string"}},{"description":"Maximum accepted data age. The default is 24h.","example":"24h","in":"query","name":"freshness","required":false,"schema":{"default":"24h","enum":["live","24h","7d","30d"],"type":"string"}},{"description":"Opaque cursor returned by the previous page.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/SuccessEnvelope"},{"properties":{"data":{"items":{"$ref":"#/components/schemas/YouTubePost"},"type":"array"}},"required":["data","meta"],"type":"object"}]}}},"description":"A successful Test or Live response.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The locator, cursor, or query is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The API key is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Live billing does not permit this request.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource is private or workspace API access is security-suspended.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource does not exist.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer accepts this cursor. Restart pagination from the first page.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer serves this data. Retrying fails the same way.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request rate limit was exceeded.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"451":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The owner of this profile asked Openhandle not to serve it.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request failed internally.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The service is temporarily unavailable.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}}},"security":[{"OpenhandleKey":[]}],"summary":"List related posts","tags":["YouTube","Post"],"x-openhandle-operation":"youtube.post.related.list","x-openhandle-sdk":{"operation":"list","paginated":true,"path":"youtube.post.related.list","scope":[{"name":"youtube"},{"name":"post","parameter":"identifier","reference":"post"},{"name":"related"}]},"x-openhandle-test-data":{"catalogUrl":"/v1/test-data?operation=youtube.post.related.list","contentHash":"sha256:7794275e0d6f248bb315a82bf631385a86ae70d2957dd815951fce7615602735","datasetVersion":"2026-10-27.2","example":{"identifier":"synthvid001"}}}},"/v1/youtube/posts/{identifier}/sound-posts":{"get":{"description":"Return the Shorts that use the sound of a public Short. Test and Live use the same route, parameters, response schema, pagination, and errors. In Test, null means unavailable, not zero.","operationId":"Youtube_post_sound_posts_list","parameters":[{"description":"Public resource reference. Profile paths accept a username with an @ prefix, such as @openai, or the stable platform ID. Post paths accept the platform post ID or shortcode.","example":"synthvid001","in":"path","name":"identifier","required":true,"schema":{"minLength":1,"type":"string"}},{"description":"Maximum accepted data age. The default is 24h.","example":"24h","in":"query","name":"freshness","required":false,"schema":{"default":"24h","enum":["live","24h","7d","30d"],"type":"string"}},{"description":"Opaque cursor returned by the previous page.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/SuccessEnvelope"},{"properties":{"data":{"items":{"$ref":"#/components/schemas/YouTubePost"},"type":"array"}},"required":["data","meta"],"type":"object"}]}}},"description":"A successful Test or Live response.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The locator, cursor, or query is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The API key is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Live billing does not permit this request.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource is private or workspace API access is security-suspended.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource does not exist.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer accepts this cursor. Restart pagination from the first page.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer serves this data. Retrying fails the same way.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request rate limit was exceeded.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"451":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The owner of this profile asked Openhandle not to serve it.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request failed internally.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The service is temporarily unavailable.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}}},"security":[{"OpenhandleKey":[]}],"summary":"List posts using the same sound","tags":["YouTube","Post"],"x-openhandle-operation":"youtube.post.sound.posts.list","x-openhandle-sdk":{"operation":"list","paginated":true,"path":"youtube.post.soundPosts.list","scope":[{"name":"youtube"},{"name":"post","parameter":"identifier","reference":"post"},{"name":"soundPosts"}]},"x-openhandle-test-data":{"catalogUrl":"/v1/test-data?operation=youtube.post.sound.posts.list","contentHash":"sha256:7794275e0d6f248bb315a82bf631385a86ae70d2957dd815951fce7615602735","datasetVersion":"2026-10-27.2","example":{"identifier":"synthvid001"}}}},"/v1/youtube/posts/{identifier}/storyboard":{"get":{"description":"Return YouTube's preview frames of a public video: one small frame every few seconds, packed into image sheets, with the position of every frame. Test and Live use the same route, parameters, response schema, pagination, and errors. In Test, null means unavailable, not zero.","operationId":"Youtube_post_storyboard_get","parameters":[{"description":"Public resource reference. Profile paths accept a username with an @ prefix, such as @openai, or the stable platform ID. Post paths accept the platform post ID or shortcode.","example":"synthvid001","in":"path","name":"identifier","required":true,"schema":{"minLength":1,"type":"string"}},{"description":"Maximum accepted data age. The default is 24h.","example":"24h","in":"query","name":"freshness","required":false,"schema":{"default":"24h","enum":["live","24h","7d","30d"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/SuccessEnvelope"},{"properties":{"data":{"$ref":"#/components/schemas/YouTubeStoryboard"}},"required":["data"],"type":"object"}]}}},"description":"A successful Test or Live response.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The locator, cursor, or query is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The API key is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Live billing does not permit this request.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource is private or workspace API access is security-suspended.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource does not exist.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer serves this data. Retrying fails the same way.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request rate limit was exceeded.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"451":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The owner of this profile asked Openhandle not to serve it.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request failed internally.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The service is temporarily unavailable.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}}},"security":[{"OpenhandleKey":[]}],"summary":"Get post storyboard","tags":["YouTube","Storyboard"],"x-openhandle-operation":"youtube.post.storyboard.get","x-openhandle-sdk":{"operation":"get","paginated":false,"path":"youtube.post.storyboard.get","scope":[{"name":"youtube"},{"name":"post","parameter":"identifier","reference":"post"},{"name":"storyboard"}]},"x-openhandle-test-data":{"catalogUrl":"/v1/test-data?operation=youtube.post.storyboard.get","contentHash":"sha256:7794275e0d6f248bb315a82bf631385a86ae70d2957dd815951fce7615602735","datasetVersion":"2026-10-27.2","example":{"identifier":"synthvid001"}}}},"/v1/youtube/posts/{identifier}/transcript":{"get":{"description":"Return the timed caption text of a public YouTube video in one of its caption languages. Test and Live use the same route, parameters, response schema, pagination, and errors. In Test, null means unavailable, not zero.","operationId":"Youtube_post_transcript_get","parameters":[{"description":"Public resource reference. Profile paths accept a username with an @ prefix, such as @openai, or the stable platform ID. Post paths accept the platform post ID or shortcode.","example":"synthvid001","in":"path","name":"identifier","required":true,"schema":{"minLength":1,"type":"string"}},{"description":"Caption language code, such as en or es-419. The default is the spoken language.","in":"query","name":"language","required":false,"schema":{"minLength":1,"type":"string"}},{"description":"Maximum accepted data age. The default is 24h.","example":"24h","in":"query","name":"freshness","required":false,"schema":{"default":"24h","enum":["live","24h","7d","30d"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/SuccessEnvelope"},{"properties":{"data":{"$ref":"#/components/schemas/YouTubeTranscript"}},"required":["data"],"type":"object"}]}}},"description":"A successful Test or Live response.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The locator, cursor, or query is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The API key is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Live billing does not permit this request.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource is private or workspace API access is security-suspended.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource does not exist.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer serves this data. Retrying fails the same way.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request rate limit was exceeded.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"451":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The owner of this profile asked Openhandle not to serve it.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request failed internally.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The service is temporarily unavailable.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}}},"security":[{"OpenhandleKey":[]}],"summary":"Get a transcript","tags":["YouTube","Transcript"],"x-openhandle-operation":"youtube.post.transcript.get","x-openhandle-sdk":{"operation":"get","paginated":false,"path":"youtube.post.transcript.get","scope":[{"name":"youtube"},{"name":"post","parameter":"identifier","reference":"post"},{"name":"transcript"}]},"x-openhandle-test-data":{"catalogUrl":"/v1/test-data?operation=youtube.post.transcript.get","contentHash":"sha256:7794275e0d6f248bb315a82bf631385a86ae70d2957dd815951fce7615602735","datasetVersion":"2026-10-27.2","example":{"identifier":"synthvid001"}}}},"/v1/youtube/profiles/{identifier}":{"get":{"description":"Return one public YouTube channel. Use @handle or the UC channel ID. Test and Live use the same route, parameters, response schema, pagination, and errors. In Test, null means unavailable, not zero.","operationId":"Youtube_profile_get","parameters":[{"description":"Public resource reference. Profile paths accept a username with an @ prefix, such as @openai, or the stable platform ID. Post paths accept the platform post ID or shortcode.","example":"@synthetic_youtube","in":"path","name":"identifier","required":true,"schema":{"minLength":1,"type":"string"}},{"description":"Maximum accepted data age. The default is 24h.","example":"24h","in":"query","name":"freshness","required":false,"schema":{"default":"24h","enum":["live","24h","7d","30d"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/SuccessEnvelope"},{"properties":{"data":{"$ref":"#/components/schemas/YouTubeProfile"}},"required":["data"],"type":"object"}]}}},"description":"A successful Test or Live response.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The locator, cursor, or query is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The API key is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Live billing does not permit this request.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource is private or workspace API access is security-suspended.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource does not exist.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer serves this data. Retrying fails the same way.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request rate limit was exceeded.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"451":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The owner of this profile asked Openhandle not to serve it.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request failed internally.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The service is temporarily unavailable.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}}},"security":[{"OpenhandleKey":[]}],"summary":"Get a profile","tags":["YouTube","Profile"],"x-openhandle-operation":"youtube.profile.get","x-openhandle-sdk":{"operation":"get","paginated":false,"path":"youtube.profile.get","scope":[{"name":"youtube"},{"name":"profile","parameter":"identifier","reference":"profile"}]},"x-openhandle-test-data":{"catalogUrl":"/v1/test-data?operation=youtube.profile.get","contentHash":"sha256:7794275e0d6f248bb315a82bf631385a86ae70d2957dd815951fce7615602735","datasetVersion":"2026-10-27.2","example":{"identifier":"@synthetic_youtube"}}}},"/v1/youtube/profiles/{identifier}/community-posts":{"get":{"description":"Return the text, image, and poll posts of a public YouTube channel. Test and Live use the same route, parameters, response schema, pagination, and errors. In Test, null means unavailable, not zero.","operationId":"Youtube_profile_community_list","parameters":[{"description":"Public resource reference. Profile paths accept a username with an @ prefix, such as @openai, or the stable platform ID. Post paths accept the platform post ID or shortcode.","example":"@synthetic_youtube","in":"path","name":"identifier","required":true,"schema":{"minLength":1,"type":"string"}},{"description":"Maximum accepted data age. The default is 24h.","example":"24h","in":"query","name":"freshness","required":false,"schema":{"default":"24h","enum":["live","24h","7d","30d"],"type":"string"}},{"description":"Opaque cursor returned by the previous page.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/SuccessEnvelope"},{"properties":{"data":{"items":{"$ref":"#/components/schemas/YouTubeCommunityPost"},"type":"array"}},"required":["data","meta"],"type":"object"}]}}},"description":"A successful Test or Live response.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The locator, cursor, or query is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The API key is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Live billing does not permit this request.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource is private or workspace API access is security-suspended.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource does not exist.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer accepts this cursor. Restart pagination from the first page.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer serves this data. Retrying fails the same way.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request rate limit was exceeded.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"451":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The owner of this profile asked Openhandle not to serve it.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request failed internally.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The service is temporarily unavailable.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}}},"security":[{"OpenhandleKey":[]}],"summary":"List profile community posts","tags":["YouTube","Post"],"x-openhandle-operation":"youtube.profile.community.list","x-openhandle-sdk":{"operation":"list","paginated":true,"path":"youtube.profile.communityPosts.list","scope":[{"name":"youtube"},{"name":"profile","parameter":"identifier","reference":"profile"},{"name":"communityPosts"}]},"x-openhandle-test-data":{"catalogUrl":"/v1/test-data?operation=youtube.profile.community.list","contentHash":"sha256:7794275e0d6f248bb315a82bf631385a86ae70d2957dd815951fce7615602735","datasetVersion":"2026-10-27.2","example":{"identifier":"@synthetic_youtube"}}}},"/v1/youtube/profiles/{identifier}/livestreams":{"get":{"description":"Return the current, upcoming, and past livestreams of a public YouTube channel. Test and Live use the same route, parameters, response schema, pagination, and errors. In Test, null means unavailable, not zero.","operationId":"Youtube_profile_livestreams_list","parameters":[{"description":"Public resource reference. Profile paths accept a username with an @ prefix, such as @openai, or the stable platform ID. Post paths accept the platform post ID or shortcode.","example":"@synthetic_youtube","in":"path","name":"identifier","required":true,"schema":{"minLength":1,"type":"string"}},{"description":"Result ordering for this operation.","example":"newest","in":"query","name":"sort","required":false,"schema":{"default":"newest","enum":["newest","popular","oldest"],"type":"string"}},{"description":"Maximum accepted data age. The default is 24h.","example":"24h","in":"query","name":"freshness","required":false,"schema":{"default":"24h","enum":["live","24h","7d","30d"],"type":"string"}},{"description":"Opaque cursor returned by the previous page.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/SuccessEnvelope"},{"properties":{"data":{"items":{"$ref":"#/components/schemas/YouTubePost"},"type":"array"}},"required":["data","meta"],"type":"object"}]}}},"description":"A successful Test or Live response.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The locator, cursor, or query is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The API key is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Live billing does not permit this request.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource is private or workspace API access is security-suspended.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource does not exist.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer accepts this cursor. Restart pagination from the first page.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer serves this data. Retrying fails the same way.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request rate limit was exceeded.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"451":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The owner of this profile asked Openhandle not to serve it.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request failed internally.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The service is temporarily unavailable.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}}},"security":[{"OpenhandleKey":[]}],"summary":"List profile livestreams","tags":["YouTube","Post"],"x-openhandle-operation":"youtube.profile.livestreams.list","x-openhandle-sdk":{"operation":"list","paginated":true,"path":"youtube.profile.livestreams.list","scope":[{"name":"youtube"},{"name":"profile","parameter":"identifier","reference":"profile"},{"name":"livestreams"}]},"x-openhandle-test-data":{"catalogUrl":"/v1/test-data?operation=youtube.profile.livestreams.list","contentHash":"sha256:7794275e0d6f248bb315a82bf631385a86ae70d2957dd815951fce7615602735","datasetVersion":"2026-10-27.2","example":{"identifier":"@synthetic_youtube"}}}},"/v1/youtube/profiles/{identifier}/playlists":{"get":{"description":"Return the public playlists of a YouTube channel. Test and Live use the same route, parameters, response schema, pagination, and errors. In Test, null means unavailable, not zero.","operationId":"Youtube_profile_playlists_list","parameters":[{"description":"Public resource reference. Profile paths accept a username with an @ prefix, such as @openai, or the stable platform ID. Post paths accept the platform post ID or shortcode.","example":"@synthetic_youtube","in":"path","name":"identifier","required":true,"schema":{"minLength":1,"type":"string"}},{"description":"Maximum accepted data age. The default is 24h.","example":"24h","in":"query","name":"freshness","required":false,"schema":{"default":"24h","enum":["live","24h","7d","30d"],"type":"string"}},{"description":"Opaque cursor returned by the previous page.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/SuccessEnvelope"},{"properties":{"data":{"items":{"$ref":"#/components/schemas/YouTubePlaylist"},"type":"array"}},"required":["data","meta"],"type":"object"}]}}},"description":"A successful Test or Live response.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The locator, cursor, or query is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The API key is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Live billing does not permit this request.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource is private or workspace API access is security-suspended.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource does not exist.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer accepts this cursor. Restart pagination from the first page.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer serves this data. Retrying fails the same way.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request rate limit was exceeded.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"451":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The owner of this profile asked Openhandle not to serve it.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request failed internally.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The service is temporarily unavailable.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}}},"security":[{"OpenhandleKey":[]}],"summary":"List profile playlists","tags":["YouTube","Playlist"],"x-openhandle-operation":"youtube.profile.playlists.list","x-openhandle-sdk":{"operation":"list","paginated":true,"path":"youtube.profile.playlists.list","scope":[{"name":"youtube"},{"name":"profile","parameter":"identifier","reference":"profile"},{"name":"playlists"}]},"x-openhandle-test-data":{"catalogUrl":"/v1/test-data?operation=youtube.profile.playlists.list","contentHash":"sha256:7794275e0d6f248bb315a82bf631385a86ae70d2957dd815951fce7615602735","datasetVersion":"2026-10-27.2","example":{"identifier":"@synthetic_youtube"}}}},"/v1/youtube/profiles/{identifier}/products":{"get":{"description":"Return the products on the store shelf of a public YouTube channel. Test and Live use the same route, parameters, response schema, pagination, and errors. In Test, null means unavailable, not zero.","operationId":"Youtube_profile_products_list","parameters":[{"description":"Public resource reference. Profile paths accept a username with an @ prefix, such as @openai, or the stable platform ID. Post paths accept the platform post ID or shortcode.","example":"@synthetic_youtube","in":"path","name":"identifier","required":true,"schema":{"minLength":1,"type":"string"}},{"description":"Maximum accepted data age. The default is 24h.","example":"24h","in":"query","name":"freshness","required":false,"schema":{"default":"24h","enum":["live","24h","7d","30d"],"type":"string"}},{"description":"Opaque cursor returned by the previous page.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/SuccessEnvelope"},{"properties":{"data":{"items":{"$ref":"#/components/schemas/YouTubeProduct"},"type":"array"}},"required":["data","meta"],"type":"object"}]}}},"description":"A successful Test or Live response.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The locator, cursor, or query is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The API key is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Live billing does not permit this request.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource is private or workspace API access is security-suspended.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource does not exist.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer accepts this cursor. Restart pagination from the first page.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer serves this data. Retrying fails the same way.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request rate limit was exceeded.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"451":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The owner of this profile asked Openhandle not to serve it.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request failed internally.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The service is temporarily unavailable.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}}},"security":[{"OpenhandleKey":[]}],"summary":"List profile products","tags":["YouTube","Product"],"x-openhandle-operation":"youtube.profile.products.list","x-openhandle-sdk":{"operation":"list","paginated":true,"path":"youtube.profile.products.list","scope":[{"name":"youtube"},{"name":"profile","parameter":"identifier","reference":"profile"},{"name":"products"}]},"x-openhandle-test-data":{"catalogUrl":"/v1/test-data?operation=youtube.profile.products.list","contentHash":"sha256:7794275e0d6f248bb315a82bf631385a86ae70d2957dd815951fce7615602735","datasetVersion":"2026-10-27.2","example":{"identifier":"@synthetic_youtube"}}}},"/v1/youtube/profiles/{identifier}/search":{"get":{"description":"Search the videos of one public YouTube channel. Test and Live use the same route, parameters, response schema, pagination, and errors. In Test, null means unavailable, not zero.","operationId":"Youtube_profile_search_list","parameters":[{"description":"Public resource reference. Profile paths accept a username with an @ prefix, such as @openai, or the stable platform ID. Post paths accept the platform post ID or shortcode.","example":"@synthetic_youtube","in":"path","name":"identifier","required":true,"schema":{"minLength":1,"type":"string"}},{"description":"Public search query.","example":"synthetic","in":"query","name":"q","required":true,"schema":{"minLength":1,"type":"string"}},{"description":"Maximum accepted data age. The default is 24h.","example":"24h","in":"query","name":"freshness","required":false,"schema":{"default":"24h","enum":["live","24h","7d","30d"],"type":"string"}},{"description":"Opaque cursor returned by the previous page.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/SuccessEnvelope"},{"properties":{"data":{"items":{"$ref":"#/components/schemas/YouTubePost"},"type":"array"}},"required":["data","meta"],"type":"object"}]}}},"description":"A successful Test or Live response.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The locator, cursor, or query is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The API key is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Live billing does not permit this request.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource is private or workspace API access is security-suspended.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource does not exist.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer accepts this cursor. Restart pagination from the first page.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer serves this data. Retrying fails the same way.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request rate limit was exceeded.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"451":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The owner of this profile asked Openhandle not to serve it.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request failed internally.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The service is temporarily unavailable.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}}},"security":[{"OpenhandleKey":[]}],"summary":"Search profile videos","tags":["YouTube","Post"],"x-openhandle-operation":"youtube.profile.search.list","x-openhandle-sdk":{"operation":"list","paginated":true,"path":"youtube.profile.search.list","scope":[{"name":"youtube"},{"name":"profile","parameter":"identifier","reference":"profile"},{"name":"search"}]},"x-openhandle-test-data":{"catalogUrl":"/v1/test-data?operation=youtube.profile.search.list","contentHash":"sha256:7794275e0d6f248bb315a82bf631385a86ae70d2957dd815951fce7615602735","datasetVersion":"2026-10-27.2","example":{"identifier":"@synthetic_youtube","query":"synthetic"}}}},"/v1/youtube/profiles/{identifier}/shorts":{"get":{"description":"Return the Shorts of a public YouTube channel. Test and Live use the same route, parameters, response schema, pagination, and errors. In Test, null means unavailable, not zero.","operationId":"Youtube_profile_shorts_list","parameters":[{"description":"Public resource reference. Profile paths accept a username with an @ prefix, such as @openai, or the stable platform ID. Post paths accept the platform post ID or shortcode.","example":"@synthetic_youtube","in":"path","name":"identifier","required":true,"schema":{"minLength":1,"type":"string"}},{"description":"Result ordering for this operation.","example":"newest","in":"query","name":"sort","required":false,"schema":{"default":"newest","enum":["newest","popular","oldest"],"type":"string"}},{"description":"Maximum accepted data age. The default is 24h.","example":"24h","in":"query","name":"freshness","required":false,"schema":{"default":"24h","enum":["live","24h","7d","30d"],"type":"string"}},{"description":"Opaque cursor returned by the previous page.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/SuccessEnvelope"},{"properties":{"data":{"items":{"$ref":"#/components/schemas/YouTubePost"},"type":"array"}},"required":["data","meta"],"type":"object"}]}}},"description":"A successful Test or Live response.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The locator, cursor, or query is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The API key is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Live billing does not permit this request.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource is private or workspace API access is security-suspended.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource does not exist.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer accepts this cursor. Restart pagination from the first page.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer serves this data. Retrying fails the same way.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request rate limit was exceeded.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"451":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The owner of this profile asked Openhandle not to serve it.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request failed internally.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The service is temporarily unavailable.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}}},"security":[{"OpenhandleKey":[]}],"summary":"List profile Shorts","tags":["YouTube","Post"],"x-openhandle-operation":"youtube.profile.shorts.list","x-openhandle-sdk":{"operation":"list","paginated":true,"path":"youtube.profile.shorts.list","scope":[{"name":"youtube"},{"name":"profile","parameter":"identifier","reference":"profile"},{"name":"shorts"}]},"x-openhandle-test-data":{"catalogUrl":"/v1/test-data?operation=youtube.profile.shorts.list","contentHash":"sha256:7794275e0d6f248bb315a82bf631385a86ae70d2957dd815951fce7615602735","datasetVersion":"2026-10-27.2","example":{"identifier":"@synthetic_youtube"}}}},"/v1/youtube/profiles/{identifier}/videos":{"get":{"description":"Return the videos of a public YouTube channel. Test and Live use the same route, parameters, response schema, pagination, and errors. In Test, null means unavailable, not zero.","operationId":"Youtube_profile_videos_list","parameters":[{"description":"Public resource reference. Profile paths accept a username with an @ prefix, such as @openai, or the stable platform ID. Post paths accept the platform post ID or shortcode.","example":"@synthetic_youtube","in":"path","name":"identifier","required":true,"schema":{"minLength":1,"type":"string"}},{"description":"Result ordering for this operation.","example":"newest","in":"query","name":"sort","required":false,"schema":{"default":"newest","enum":["newest","popular","oldest"],"type":"string"}},{"description":"Return posts captured at or after this RFC 3339 timestamp.","in":"query","name":"since","required":false,"schema":{"format":"date-time","type":"string"}},{"description":"Maximum accepted data age. The default is 24h.","example":"24h","in":"query","name":"freshness","required":false,"schema":{"default":"24h","enum":["live","24h","7d","30d"],"type":"string"}},{"description":"Opaque cursor returned by the previous page.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/SuccessEnvelope"},{"properties":{"data":{"items":{"$ref":"#/components/schemas/YouTubePost"},"type":"array"}},"required":["data","meta"],"type":"object"}]}}},"description":"A successful Test or Live response.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The locator, cursor, or query is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The API key is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Live billing does not permit this request.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource is private or workspace API access is security-suspended.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource does not exist.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer accepts this cursor. Restart pagination from the first page.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer serves this data. Retrying fails the same way.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request rate limit was exceeded.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"451":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The owner of this profile asked Openhandle not to serve it.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request failed internally.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The service is temporarily unavailable.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}}},"security":[{"OpenhandleKey":[]}],"summary":"List profile videos","tags":["YouTube","Post"],"x-openhandle-operation":"youtube.profile.videos.list","x-openhandle-sdk":{"operation":"list","paginated":true,"path":"youtube.profile.videos.list","scope":[{"name":"youtube"},{"name":"profile","parameter":"identifier","reference":"profile"},{"name":"videos"}]},"x-openhandle-test-data":{"catalogUrl":"/v1/test-data?operation=youtube.profile.videos.list","contentHash":"sha256:7794275e0d6f248bb315a82bf631385a86ae70d2957dd815951fce7615602735","datasetVersion":"2026-10-27.2","example":{"identifier":"@synthetic_youtube"}}}},"/v1/youtube/search/playlists":{"get":{"description":"Search public YouTube playlists and podcasts. Test and Live use the same route, parameters, response schema, pagination, and errors. In Test, null means unavailable, not zero.","operationId":"Youtube_search_playlists_list","parameters":[{"description":"Public search query.","example":"synthetic","in":"query","name":"q","required":true,"schema":{"minLength":1,"type":"string"}},{"description":"Maximum accepted data age. The default is 24h.","example":"24h","in":"query","name":"freshness","required":false,"schema":{"default":"24h","enum":["live","24h","7d","30d"],"type":"string"}},{"description":"Opaque cursor returned by the previous page.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/SuccessEnvelope"},{"properties":{"data":{"items":{"$ref":"#/components/schemas/YouTubePlaylist"},"type":"array"}},"required":["data","meta"],"type":"object"}]}}},"description":"A successful Test or Live response.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The locator, cursor, or query is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The API key is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Live billing does not permit this request.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource is private or workspace API access is security-suspended.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource does not exist.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer accepts this cursor. Restart pagination from the first page.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer serves this data. Retrying fails the same way.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request rate limit was exceeded.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"451":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The owner of this profile asked Openhandle not to serve it.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request failed internally.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The service is temporarily unavailable.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}}},"security":[{"OpenhandleKey":[]}],"summary":"Search playlists","tags":["YouTube","Playlist"],"x-openhandle-operation":"youtube.search.playlists.list","x-openhandle-sdk":{"operation":"list","paginated":true,"path":"youtube.search.playlists.list","scope":[{"name":"youtube"},{"name":"search"},{"name":"playlists"}]},"x-openhandle-test-data":{"catalogUrl":"/v1/test-data?operation=youtube.search.playlists.list","contentHash":"sha256:7794275e0d6f248bb315a82bf631385a86ae70d2957dd815951fce7615602735","datasetVersion":"2026-10-27.2","example":{"query":"synthetic"}}}},"/v1/youtube/search/posts":{"get":{"description":"Search public YouTube videos or Shorts. Test and Live use the same route, parameters, response schema, pagination, and errors. In Test, null means unavailable, not zero.","operationId":"Youtube_search_posts_list","parameters":[{"description":"Public search query.","example":"synthetic","in":"query","name":"q","required":true,"schema":{"minLength":1,"type":"string"}},{"description":"Result ordering for this operation.","example":"relevance","in":"query","name":"sort","required":false,"schema":{"default":"relevance","enum":["relevance","rating","date","views"],"type":"string"}},{"description":"Media type filter.","example":"video","in":"query","name":"type","required":false,"schema":{"enum":["video","short"],"type":"string"}},{"description":"Video length: short is under 4 minutes, medium 4 to 20, long over 20.","example":"short","in":"query","name":"duration","required":false,"schema":{"enum":["short","medium","long"],"type":"string"}},{"description":"Upload time window.","example":"hour","in":"query","name":"uploaded","required":false,"schema":{"enum":["hour","today","week","month","year"],"type":"string"}},{"description":"Maximum accepted data age. The default is 24h.","example":"24h","in":"query","name":"freshness","required":false,"schema":{"default":"24h","enum":["live","24h","7d","30d"],"type":"string"}},{"description":"Opaque cursor returned by the previous page.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/SuccessEnvelope"},{"properties":{"data":{"items":{"$ref":"#/components/schemas/YouTubePost"},"type":"array"}},"required":["data","meta"],"type":"object"}]}}},"description":"A successful Test or Live response.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The locator, cursor, or query is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The API key is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Live billing does not permit this request.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource is private or workspace API access is security-suspended.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource does not exist.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer accepts this cursor. Restart pagination from the first page.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer serves this data. Retrying fails the same way.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request rate limit was exceeded.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"451":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The owner of this profile asked Openhandle not to serve it.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request failed internally.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The service is temporarily unavailable.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}}},"security":[{"OpenhandleKey":[]}],"summary":"Search posts","tags":["YouTube","Post"],"x-openhandle-operation":"youtube.search.posts.list","x-openhandle-sdk":{"operation":"list","paginated":true,"path":"youtube.search.posts.list","scope":[{"name":"youtube"},{"name":"search"},{"name":"posts"}]},"x-openhandle-test-data":{"catalogUrl":"/v1/test-data?operation=youtube.search.posts.list","contentHash":"sha256:7794275e0d6f248bb315a82bf631385a86ae70d2957dd815951fce7615602735","datasetVersion":"2026-10-27.2","example":{"query":"synthetic"}}}},"/v1/youtube/search/profiles":{"get":{"description":"Search public YouTube channels. Test and Live use the same route, parameters, response schema, pagination, and errors. In Test, null means unavailable, not zero.","operationId":"Youtube_search_profiles_list","parameters":[{"description":"Public search query.","example":"synthetic","in":"query","name":"q","required":true,"schema":{"minLength":1,"type":"string"}},{"description":"Maximum accepted data age. The default is 24h.","example":"24h","in":"query","name":"freshness","required":false,"schema":{"default":"24h","enum":["live","24h","7d","30d"],"type":"string"}},{"description":"Opaque cursor returned by the previous page.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/SuccessEnvelope"},{"properties":{"data":{"items":{"$ref":"#/components/schemas/YouTubeProfile"},"type":"array"}},"required":["data","meta"],"type":"object"}]}}},"description":"A successful Test or Live response.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The locator, cursor, or query is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The API key is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Live billing does not permit this request.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource is private or workspace API access is security-suspended.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource does not exist.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer accepts this cursor. Restart pagination from the first page.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer serves this data. Retrying fails the same way.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request rate limit was exceeded.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"451":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The owner of this profile asked Openhandle not to serve it.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request failed internally.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The service is temporarily unavailable.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}}},"security":[{"OpenhandleKey":[]}],"summary":"Search profiles","tags":["YouTube","Profile"],"x-openhandle-operation":"youtube.search.profiles.list","x-openhandle-sdk":{"operation":"list","paginated":true,"path":"youtube.search.profiles.list","scope":[{"name":"youtube"},{"name":"search"},{"name":"profiles"}]},"x-openhandle-test-data":{"catalogUrl":"/v1/test-data?operation=youtube.search.profiles.list","contentHash":"sha256:7794275e0d6f248bb315a82bf631385a86ae70d2957dd815951fce7615602735","datasetVersion":"2026-10-27.2","example":{"query":"synthetic"}}}},"/v1/youtube/search/suggestions":{"get":{"description":"Return the autocomplete queries YouTube offers for a partial search. Test and Live use the same route, parameters, response schema, pagination, and errors. In Test, null means unavailable, not zero.","operationId":"Youtube_search_suggestions_list","parameters":[{"description":"Public search query.","example":"synthetic","in":"query","name":"q","required":true,"schema":{"minLength":1,"type":"string"}},{"description":"Maximum accepted data age. The default is 24h.","example":"24h","in":"query","name":"freshness","required":false,"schema":{"default":"24h","enum":["live","24h","7d","30d"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/SuccessEnvelope"},{"properties":{"data":{"items":{"$ref":"#/components/schemas/YouTubeSuggestion"},"type":"array"}},"required":["data"],"type":"object"}]}}},"description":"A successful Test or Live response.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The locator, cursor, or query is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The API key is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Live billing does not permit this request.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource is private or workspace API access is security-suspended.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource does not exist.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer serves this data. Retrying fails the same way.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request rate limit was exceeded.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"451":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The owner of this profile asked Openhandle not to serve it.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request failed internally.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The service is temporarily unavailable.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}}},"security":[{"OpenhandleKey":[]}],"summary":"Search suggestions","tags":["YouTube","Entity"],"x-openhandle-operation":"youtube.search.suggestions.list","x-openhandle-sdk":{"operation":"list","paginated":false,"path":"youtube.search.suggestions.list","scope":[{"name":"youtube"},{"name":"search"},{"name":"suggestions"}]},"x-openhandle-test-data":{"catalogUrl":"/v1/test-data?operation=youtube.search.suggestions.list","contentHash":"sha256:7794275e0d6f248bb315a82bf631385a86ae70d2957dd815951fce7615602735","datasetVersion":"2026-10-27.2","example":{"query":"synthetic"}}}},"/v1/youtube/trending/posts":{"get":{"description":"Return the trending YouTube videos of one country. Test and Live use the same route, parameters, response schema, pagination, and errors. In Test, null means unavailable, not zero.","operationId":"Youtube_trending_posts_list","parameters":[{"description":"Two-letter ISO 3166 country code. The default is US.","in":"query","name":"country","required":false,"schema":{"minLength":1,"type":"string"}},{"description":"Trending category.","example":"now","in":"query","name":"category","required":false,"schema":{"enum":["now","music","games","movies"],"type":"string"}},{"description":"Maximum accepted data age. The default is 24h.","example":"24h","in":"query","name":"freshness","required":false,"schema":{"default":"24h","enum":["live","24h","7d","30d"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/SuccessEnvelope"},{"properties":{"data":{"items":{"$ref":"#/components/schemas/YouTubePost"},"type":"array"}},"required":["data"],"type":"object"}]}}},"description":"A successful Test or Live response.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The locator, cursor, or query is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The API key is invalid.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Live billing does not permit this request.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource is private or workspace API access is security-suspended.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The resource does not exist.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"410":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The upstream source no longer serves this data. Retrying fails the same way.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request rate limit was exceeded.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"451":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The owner of this profile asked Openhandle not to serve it.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The request failed internally.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"The service is temporarily unavailable.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","prepaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent price for the source and freshness that answered. A cache hit shows the cache price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a throttled request. Present on 429 responses.","example":"1","schema":{"type":"string"}},"X-Request-ID":{"description":"Stable request identifier.","schema":{"type":"string"}}}}},"security":[{"OpenhandleKey":[]}],"summary":"List trending posts","tags":["YouTube","Post"],"x-openhandle-operation":"youtube.trending.posts.list","x-openhandle-sdk":{"operation":"list","paginated":false,"path":"youtube.trending.posts.list","scope":[{"name":"youtube"},{"name":"trending"},{"name":"posts"}]},"x-openhandle-test-data":{"catalogUrl":"/v1/test-data?operation=youtube.trending.posts.list","contentHash":"sha256:7794275e0d6f248bb315a82bf631385a86ae70d2957dd815951fce7615602735","datasetVersion":"2026-10-27.2","example":{"id":"","q":"","query":""}}}}},"servers":[{"url":"https://api.openhandle.dev"}],"x-openhandle-mcp":{"documentation":"https://openhandle.dev/docs/mcp","protectedResourceMetadata":"https://api.openhandle.dev/.well-known/oauth-protected-resource/mcp","scopesSupported":["mcp","read:instagram","read:tiktok","read:twitter","read:reddit","read:youtube","read:account"],"securityScheme":"OpenhandleMCPOAuth","transport":"streamable-http","url":"https://api.openhandle.dev/mcp"},"x-openhandle-sdks":[{"documentation":"https://openhandle.dev/docs/sdks","language":"TypeScript","package":"@openhandle/sdk","repository":"https://github.com/openhandlehq/openhandle-typescript"},{"documentation":"https://openhandle.dev/docs/sdks","language":"Go","package":"github.com/openhandlehq/openhandle-go","repository":"https://github.com/openhandlehq/openhandle-go"},{"documentation":"https://openhandle.dev/docs/sdks","language":"Python","package":"openhandle","repository":"https://github.com/openhandlehq/openhandle-python"},{"documentation":"https://openhandle.dev/docs/sdks","language":"PHP","package":"openhandle/sdk","repository":"https://github.com/openhandlehq/openhandle-php"},{"documentation":"https://openhandle.dev/docs/sdks","language":"Rust","package":"openhandle","repository":"https://github.com/openhandlehq/openhandle-rust"}],"x-openhandle-test-data":{"catalogUrl":"/v1/test-data","contentHash":"sha256:7794275e0d6f248bb315a82bf631385a86ae70d2957dd815951fce7615602735","datasetVersion":"2026-10-27.2"},"x-openhandle-versioning-policy":"https://openhandle.dev/docs/versioning"}