{"components":{"schemas":{"Comment":{"$ref":"#/components/schemas/CommentCore"},"CommentCore":{"properties":{"author":{"$ref":"#/components/schemas/PostAuthor"},"id":{"minLength":1,"type":"string"},"isLikedByPostAuthor":{"type":["boolean","null"]},"isPinned":{"type":["boolean","null"]},"media":{"items":{"$ref":"#/components/schemas/PostMedia"},"type":"array"},"metrics":{"$ref":"#/components/schemas/CommentMetrics"},"parentId":{"type":["string","null"]},"pinnedPosition":{"type":["integer","null"]},"publishedAt":{"format":"date-time","type":"string"},"replyPreview":{"items":{"$ref":"#/components/schemas/Comment"},"type":"array"},"text":{"type":"string"},"threadRootId":{"type":["string","null"]}},"required":["id","text","publishedAt","author","metrics","parentId","threadRootId","isPinned","pinnedPosition","isLikedByPostAuthor","media"],"type":"object"},"CommentMetrics":{"additionalProperties":false,"properties":{"bookmarks":{"type":["integer","null"]},"likes":{"type":["integer","null"]},"quotes":{"type":["integer","null"]},"replies":{"type":["integer","null"]},"reposts":{"type":["integer","null"]},"views":{"type":["integer","null"]}},"required":["likes","replies","views","reposts","quotes","bookmarks"],"type":"object"},"Entity":{"$ref":"#/components/schemas/EntityCore"},"EntityCore":{"properties":{"attributes":{"additionalProperties":{"type":"string"},"type":"object"},"description":{"type":["string","null"]},"handle":{"type":["string","null"]},"id":{"minLength":1,"type":"string"},"image":{"anyOf":[{"$ref":"#/components/schemas/MediaReference"},{"type":"null"}]},"kind":{"minLength":1,"type":"string"},"metrics":{"additionalProperties":{"type":["integer","null"]},"type":"object"},"name":{"type":["string","null"]},"url":{"format":"uri","type":["string","null"]}},"required":["id","kind","name","description","url","image","handle","attributes","metrics"],"type":"object"},"EntityReference":{"additionalProperties":false,"properties":{"handle":{"minLength":1,"type":"string"},"id":{"minLength":1,"type":"string"},"image":{"$ref":"#/components/schemas/MediaReference"},"name":{"minLength":1,"type":"string"},"url":{"format":"uri","type":"string"}},"required":["id"],"type":"object"},"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"},"Hashtag":{"additionalProperties":false,"properties":{"description":{"type":["string","null"]},"id":{"minLength":1,"type":"string"},"image":{"anyOf":[{"$ref":"#/components/schemas/MediaReference"},{"type":"null"}]},"metrics":{"additionalProperties":false,"properties":{"posts":{"type":["integer","null"]},"views":{"type":["integer","null"]}},"required":["posts","views"],"type":"object"},"name":{"minLength":1,"type":"string"}},"required":["id","name","description","image","metrics"],"type":"object"},"InstagramClipMetadata":{"additionalProperties":false,"properties":{"author":{"$ref":"#/components/schemas/EntityReference"},"caption":{"minLength":1,"type":"string"},"duration":{"type":"number"},"height":{"type":"integer"},"id":{"minLength":1,"type":"string"},"media":{"items":{"$ref":"#/components/schemas/PostMedia"},"type":"array"},"music":{"$ref":"#/components/schemas/PostMusic"},"playCount":{"type":"integer"},"publishedAt":{"format":"date-time","type":"string"},"title":{"minLength":1,"type":"string"},"viewCount":{"type":"integer"},"width":{"type":"integer"}},"required":["id","media"],"type":"object"},"InstagramComment":{"allOf":[{"$ref":"#/components/schemas/CommentCore"}],"unevaluatedProperties":false},"InstagramCommentMetadata":{"additionalProperties":false,"properties":{"canComment":{"type":"boolean"},"canViewMore":{"type":"boolean"},"commentCount":{"type":"integer"},"commentsDisabled":{"type":"boolean"},"id":{"minLength":1,"type":"string"},"previewCount":{"type":"integer"}},"required":["id"],"type":"object"},"InstagramCommentModeration":{"additionalProperties":false,"properties":{"id":{"minLength":1,"type":"string"},"isBullying":{"type":"boolean"},"isOffensive":{"type":"boolean"},"isSpam":{"type":"boolean"},"reasons":{"items":{"minLength":1,"type":"string"},"type":"array"},"score":{"type":"number"},"text":{"minLength":1,"type":"string"}},"required":["id","reasons"],"type":"object"},"InstagramEntity":{"allOf":[{"$ref":"#/components/schemas/EntityCore"}],"unevaluatedProperties":false},"InstagramHighlight":{"additionalProperties":false,"properties":{"cover":{"$ref":"#/components/schemas/MediaReference"},"id":{"minLength":1,"type":"string"},"itemCount":{"type":"integer"},"items":{"items":{"$ref":"#/components/schemas/InstagramStory"},"type":"array"},"owner":{"$ref":"#/components/schemas/EntityReference"},"title":{"minLength":1,"type":"string"}},"required":["id","items"],"type":"object"},"InstagramLocationGuide":{"additionalProperties":false,"properties":{"author":{"$ref":"#/components/schemas/EntityReference"},"description":{"minLength":1,"type":"string"},"id":{"minLength":1,"type":"string"},"image":{"$ref":"#/components/schemas/MediaReference"},"itemCount":{"type":"integer"},"location":{"$ref":"#/components/schemas/PostLocation"},"title":{"minLength":1,"type":"string"},"url":{"format":"uri","type":"string"}},"required":["id"],"type":"object"},"InstagramMusicStream":{"additionalProperties":false,"properties":{"bitrate":{"type":"integer"},"duration":{"type":"number"},"expiresAt":{"format":"date-time","type":"string"},"id":{"minLength":1,"type":"string"},"mimeType":{"minLength":1,"type":"string"},"page":{"type":"integer"},"url":{"format":"uri","type":"string"}},"required":["id"],"type":"object"},"InstagramOEmbed":{"additionalProperties":false,"properties":{"authorName":{"minLength":1,"type":"string"},"authorUrl":{"format":"uri","type":"string"},"height":{"type":"integer"},"html":{"minLength":1,"type":"string"},"id":{"minLength":1,"type":"string"},"providerName":{"minLength":1,"type":"string"},"providerUrl":{"format":"uri","type":"string"},"thumbnail":{"$ref":"#/components/schemas/MediaReference"},"title":{"minLength":1,"type":"string"},"type":{"minLength":1,"type":"string"},"url":{"format":"uri","type":"string"},"width":{"type":"integer"}},"required":["id"],"type":"object"},"InstagramPlayCountBreakdown":{"additionalProperties":false,"properties":{"facebook":{"type":["integer","null"]},"instagram":{"type":["integer","null"]}},"required":["instagram","facebook"],"type":"object"},"InstagramPost":{"allOf":[{"$ref":"#/components/schemas/PostCore"},{"properties":{"collaborators":{"anyOf":[{"items":{"$ref":"#/components/schemas/PostAuthor"},"type":"array"},{"type":"null"}]},"extended":{"$ref":"#/components/schemas/InstagramPostExtended"},"isAd":{"type":["boolean","null"]},"isPaidPartnership":{"type":["boolean","null"]},"location":{"anyOf":[{"$ref":"#/components/schemas/PostLocation"},{"type":"null"}]},"metrics":{"$ref":"#/components/schemas/InstagramPostMetrics"},"music":{"anyOf":[{"$ref":"#/components/schemas/PostMusic"},{"type":"null"}]},"shortcode":{"type":["string","null"]},"sponsors":{"anyOf":[{"items":{"$ref":"#/components/schemas/PostAuthor"},"type":"array"},{"type":"null"}]},"taggedUsers":{"anyOf":[{"items":{"$ref":"#/components/schemas/PostAuthor"},"type":"array"},{"type":"null"}]}},"required":["metrics","taggedUsers","collaborators","sponsors","location","music","isAd","isPaidPartnership","shortcode"],"type":"object"}],"unevaluatedProperties":false},"InstagramPostExtended":{"additionalProperties":false,"properties":{"accessibilityCaption":{"type":["string","null"]},"likeCountsHidden":{"type":["boolean","null"]},"productType":{"type":["string","null"]}},"required":["accessibilityCaption","productType","likeCountsHidden"],"type":"object"},"InstagramPostInsight":{"additionalProperties":false,"properties":{"averageWatchTime":{"type":"number"},"comments":{"type":"integer"},"follows":{"type":"integer"},"id":{"minLength":1,"type":"string"},"impressions":{"type":"integer"},"interactions":{"type":"integer"},"likes":{"type":"integer"},"plays":{"type":"integer"},"profileVisits":{"type":"integer"},"reach":{"type":"integer"},"saves":{"type":"integer"},"shares":{"type":"integer"},"views":{"type":"integer"},"watchTime":{"type":"number"}},"required":["id"],"type":"object"},"InstagramPostMetrics":{"allOf":[{"$ref":"#/components/schemas/PostMetrics"},{"properties":{"playCountBreakdown":{"anyOf":[{"$ref":"#/components/schemas/InstagramPlayCountBreakdown"},{"type":"null"}]}},"type":"object"}],"unevaluatedProperties":false},"InstagramProfile":{"allOf":[{"$ref":"#/components/schemas/ProfileCore"},{"properties":{"extended":{"$ref":"#/components/schemas/InstagramProfileExtended"}},"type":"object"}],"unevaluatedProperties":false},"InstagramProfileAbout":{"additionalProperties":false,"properties":{"bio":{"minLength":1,"type":"string"},"category":{"minLength":1,"type":"string"},"country":{"minLength":1,"type":"string"},"displayName":{"minLength":1,"type":"string"},"externalUrl":{"format":"uri","type":"string"},"formerUsernameCount":{"type":"integer"},"handle":{"minLength":1,"type":"string"},"id":{"minLength":1,"type":"string"},"isBusiness":{"type":"boolean"},"isPrivate":{"type":"boolean"},"isVerified":{"type":"boolean"},"joinedAt":{"format":"date-time","type":"string"}},"required":["id"],"type":"object"},"InstagramProfileExtended":{"additionalProperties":false,"properties":{"accountTypeCode":{"type":["integer","null"]},"addressStreet":{"type":["string","null"]},"bioLinks":{"items":{"$ref":"#/components/schemas/ProfileLink"},"type":"array"},"businessContactMethod":{"type":["string","null"]},"city":{"type":["string","null"]},"latitude":{"type":["number","null"]},"longitude":{"type":["number","null"]},"postalCode":{"type":["string","null"]},"publicEmail":{"type":["string","null"]},"publicPhoneCountryCode":{"type":["string","null"]},"publicPhoneNumber":{"type":["string","null"]}},"required":["bioLinks","publicEmail","publicPhoneCountryCode","publicPhoneNumber","businessContactMethod","addressStreet","city","postalCode","latitude","longitude","accountTypeCode"],"type":"object"},"InstagramProfileSummary":{"additionalProperties":false,"properties":{"avatar":{"$ref":"#/components/schemas/MediaReference"},"bio":{"minLength":1,"type":"string"},"category":{"minLength":1,"type":"string"},"displayName":{"minLength":1,"type":"string"},"followers":{"type":"integer"},"handle":{"minLength":1,"type":"string"},"id":{"minLength":1,"type":"string"},"isPrivate":{"type":"boolean"},"isVerified":{"type":"boolean"},"url":{"format":"uri","type":"string"}},"required":["id"],"type":"object"},"InstagramSearchResult":{"additionalProperties":false,"properties":{"author":{"$ref":"#/components/schemas/EntityReference"},"description":{"minLength":1,"type":"string"},"handle":{"minLength":1,"type":"string"},"id":{"minLength":1,"type":"string"},"image":{"$ref":"#/components/schemas/MediaReference"},"metrics":{"$ref":"#/components/schemas/SearchResultMetrics"},"title":{"minLength":1,"type":"string"},"type":{"minLength":1,"type":"string"},"url":{"format":"uri","type":"string"}},"required":["id"],"type":"object"},"InstagramStory":{"additionalProperties":false,"properties":{"author":{"$ref":"#/components/schemas/EntityReference"},"canQuickReply":{"type":"boolean"},"canReply":{"type":"boolean"},"canReshare":{"type":"boolean"},"expiresAt":{"format":"date-time","type":"string"},"hashtags":{"items":{"minLength":1,"type":"string"},"type":"array"},"id":{"minLength":1,"type":"string"},"links":{"items":{"$ref":"#/components/schemas/StoryLink"},"type":"array"},"locations":{"items":{"$ref":"#/components/schemas/PostLocation"},"type":"array"},"media":{"items":{"$ref":"#/components/schemas/PostMedia"},"type":"array"},"mentions":{"items":{"$ref":"#/components/schemas/EntityReference"},"type":"array"},"publishedAt":{"format":"date-time","type":"string"},"shortcode":{"minLength":1,"type":"string"},"stickers":{"items":{"$ref":"#/components/schemas/StorySticker"},"type":"array"},"type":{"enum":["image","video"],"type":"string"}},"required":["id","media","mentions","links","hashtags","locations","stickers"],"type":"object"},"InstagramTemplate":{"additionalProperties":false,"properties":{"author":{"$ref":"#/components/schemas/EntityReference"},"description":{"minLength":1,"type":"string"},"duration":{"type":"number"},"id":{"minLength":1,"type":"string"},"media":{"items":{"$ref":"#/components/schemas/PostMedia"},"type":"array"},"name":{"minLength":1,"type":"string"},"type":{"minLength":1,"type":"string"},"url":{"format":"uri","type":"string"}},"required":["id","media"],"type":"object"},"Location":{"additionalProperties":false,"properties":{"address":{"type":["string","null"]},"category":{"type":["string","null"]},"city":{"type":["string","null"]},"countryCode":{"type":["string","null"]},"id":{"minLength":1,"type":"string"},"latitude":{"type":["number","null"]},"longitude":{"type":["number","null"]},"name":{"minLength":1,"type":"string"},"phone":{"type":["string","null"]},"postalCode":{"type":["string","null"]},"region":{"type":["string","null"]},"website":{"format":"uri","type":["string","null"]}},"required":["id","name","category","address","city","region","countryCode","postalCode","latitude","longitude","website","phone"],"type":"object"},"MediaReference":{"additionalProperties":false,"properties":{"expiresAt":{"format":"date-time","type":"string"},"url":{"format":"uri","type":"string"}},"required":["url"],"type":"object"},"MessageEnvelope":{"additionalProperties":false,"properties":{"message":{"minLength":1,"type":"string"}},"required":["message"],"type":"object"},"Music":{"additionalProperties":false,"properties":{"album":{"type":["string","null"]},"artist":{"anyOf":[{"$ref":"#/components/schemas/PostMusicArtist"},{"type":"null"}]},"artwork":{"anyOf":[{"$ref":"#/components/schemas/MediaReference"},{"type":"null"}]},"audio":{"anyOf":[{"$ref":"#/components/schemas/MediaReference"},{"type":"null"}]},"duration":{"type":["number","null"]},"id":{"minLength":1,"type":"string"},"isCommercial":{"type":["boolean","null"]},"isExplicit":{"type":["boolean","null"]},"isOriginal":{"type":["boolean","null"]},"metrics":{"additionalProperties":false,"properties":{"posts":{"type":["integer","null"]}},"required":["posts"],"type":"object"},"title":{"minLength":1,"type":"string"}},"required":["id","title","artist","album","duration","isOriginal","isExplicit","isCommercial","artwork","audio","metrics"],"type":"object"},"PostAuthor":{"additionalProperties":false,"properties":{"avatar":{"anyOf":[{"$ref":"#/components/schemas/MediaReference"},{"type":"null"}]},"displayName":{"type":["string","null"]},"handle":{"minLength":1,"type":"string"},"id":{"minLength":1,"type":"string"},"isVerified":{"type":["boolean","null"]}},"required":["id","handle","displayName","avatar","isVerified"],"type":"object"},"PostCore":{"properties":{"author":{"$ref":"#/components/schemas/PostAuthor"},"caption":{"type":["string","null"]},"commentsDisabled":{"type":["boolean","null"]},"format":{"enum":["post","reel","story"],"type":"string"},"hashtags":{"items":{"minLength":1,"type":"string"},"type":"array"},"id":{"minLength":1,"type":"string"},"media":{"items":{"$ref":"#/components/schemas/PostMedia"},"type":"array"},"mentions":{"items":{"minLength":1,"type":"string"},"type":"array"},"publishedAt":{"format":"date-time","type":"string"},"title":{"type":["string","null"]},"type":{"enum":["text","image","video","carousel"],"type":"string"},"url":{"format":"uri","type":"string"}},"required":["id","url","type","format","title","caption","publishedAt","author","media","hashtags","mentions","commentsDisabled"],"type":"object"},"PostLocation":{"additionalProperties":false,"properties":{"address":{"type":["string","null"]},"category":{"type":["string","null"]},"city":{"type":["string","null"]},"countryCode":{"type":["string","null"]},"id":{"type":["string","null"]},"latitude":{"type":["number","null"]},"longitude":{"type":["number","null"]},"name":{"type":["string","null"]},"phone":{"type":["string","null"]},"postalCode":{"type":["string","null"]},"region":{"type":["string","null"]},"website":{"type":["string","null"]}},"required":["id","name","category","address","city","region","countryCode","postalCode","website","phone","latitude","longitude"],"type":"object"},"PostMedia":{"additionalProperties":false,"properties":{"altText":{"type":"string"},"duration":{"type":"number"},"expiresAt":{"format":"date-time","type":"string"},"height":{"type":"integer"},"id":{"minLength":1,"type":"string"},"thumbnail":{"$ref":"#/components/schemas/MediaReference"},"type":{"enum":["image","video"],"type":"string"},"url":{"format":"uri","type":"string"},"variants":{"items":{"$ref":"#/components/schemas/PostMediaVariant"},"type":"array"},"width":{"type":"integer"}},"required":["type","url"],"type":"object"},"PostMediaVariant":{"additionalProperties":false,"properties":{"bitrate":{"type":"integer"},"expiresAt":{"format":"date-time","type":"string"},"height":{"type":"integer"},"mimeType":{"type":"string"},"role":{"type":"string"},"url":{"format":"uri","type":"string"},"watermarked":{"type":"boolean"},"width":{"type":"integer"}},"required":["url"],"type":"object"},"PostMetrics":{"properties":{"comments":{"type":["integer","null"]},"likes":{"type":["integer","null"]},"reposts":{"type":["integer","null"]},"saves":{"type":["integer","null"]},"shares":{"type":["integer","null"]},"views":{"type":["integer","null"]}},"required":["views","likes","comments","shares","reposts","saves"],"type":"object"},"PostMusic":{"additionalProperties":false,"properties":{"album":{"type":["string","null"]},"artist":{"anyOf":[{"$ref":"#/components/schemas/PostMusicArtist"},{"type":"null"}]},"artwork":{"anyOf":[{"$ref":"#/components/schemas/MediaReference"},{"type":"null"}]},"audio":{"anyOf":[{"$ref":"#/components/schemas/MediaReference"},{"type":"null"}]},"duration":{"type":["number","null"]},"id":{"minLength":1,"type":"string"},"isCommercial":{"type":["boolean","null"]},"isExplicit":{"type":["boolean","null"]},"isOriginal":{"type":["boolean","null"]},"title":{"type":["string","null"]}},"required":["id","title","artist","album","duration","isOriginal","isExplicit","isCommercial","artwork","audio"],"type":"object"},"PostMusicArtist":{"additionalProperties":false,"properties":{"id":{"type":["string","null"]},"name":{"minLength":1,"type":"string"}},"required":["id","name"],"type":"object"},"Profile":{"$ref":"#/components/schemas/ProfileCore"},"ProfileCore":{"properties":{"accountType":{"enum":["page","profile",null],"type":["string","null"]},"avatar":{"anyOf":[{"$ref":"#/components/schemas/MediaReference"},{"type":"null"}]},"bio":{"type":"string"},"category":{"type":["string","null"]},"displayName":{"minLength":1,"type":"string"},"externalUrl":{"format":"uri","type":["string","null"]},"handle":{"minLength":1,"type":"string"},"id":{"minLength":1,"type":"string"},"isBusiness":{"type":"boolean"},"isPrivate":{"type":"boolean"},"isVerified":{"type":"boolean"},"metrics":{"$ref":"#/components/schemas/ProfileMetrics"}},"required":["id","handle","displayName","bio","avatar","externalUrl","isVerified","isPrivate","isBusiness","category","accountType","metrics"],"type":"object"},"ProfileLink":{"additionalProperties":false,"properties":{"title":{"type":["string","null"]},"url":{"format":"uri","type":"string"}},"required":["title","url"],"type":"object"},"ProfileMetrics":{"additionalProperties":false,"properties":{"followers":{"type":["integer","null"]},"following":{"type":["integer","null"]},"posts":{"type":["integer","null"]}},"required":["followers","following","posts"],"type":"object"},"SearchResultMetrics":{"additionalProperties":false,"properties":{"comments":{"type":"integer"},"followers":{"type":"integer"},"likes":{"type":"integer"},"posts":{"type":"integer"},"shares":{"type":"integer"},"views":{"type":"integer"}},"type":"object"},"StoryLink":{"additionalProperties":false,"properties":{"displayUrl":{"minLength":1,"type":"string"},"height":{"type":"number"},"rotation":{"type":"number"},"title":{"minLength":1,"type":"string"},"url":{"format":"uri","type":"string"},"width":{"type":"number"},"x":{"type":"number"},"y":{"type":"number"}},"required":["url"],"type":"object"},"StorySticker":{"additionalProperties":false,"properties":{"height":{"type":"number"},"id":{"minLength":1,"type":"string"},"link":{"$ref":"#/components/schemas/StoryLink"},"rotation":{"type":"number"},"type":{"minLength":1,"type":"string"},"width":{"type":"number"},"x":{"type":"number"},"y":{"type":"number"}},"type":"object"},"SuccessEnvelope":{"additionalProperties":false,"properties":{"capturedAt":{"format":"date-time","type":"string"},"data":{},"meta":{"properties":{"cursors":{"properties":{"next":{"type":["string","null"]}},"required":["next"],"type":"object"}},"required":["cursors"],"type":"object"},"platform":{"enum":["instagram","tiktok","twitter"],"type":"string"},"resource":{"enum":["profile","post","comment","hashtag","location","music","category","list","entity"],"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"],"type":"string"},"relationships":{"items":{"$ref":"#/components/schemas/TestDataRelationship"},"type":"array"},"resource":{"enum":["profile","post","comment","hashtag","location","music","category","list","entity"],"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"],"type":"string"},"publicSchema":{"minLength":1,"type":"string"},"resource":{"enum":["profile","post","comment","hashtag","location","music","category","list","entity"],"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"},"TikTokComment":{"allOf":[{"$ref":"#/components/schemas/CommentCore"}],"unevaluatedProperties":false},"TikTokEffect":{"additionalProperties":false,"properties":{"createdAt":{"format":"date-time","type":"string"},"description":{"minLength":1,"type":"string"},"id":{"minLength":1,"type":"string"},"image":{"$ref":"#/components/schemas/MediaReference"},"isCommercial":{"type":"boolean"},"name":{"minLength":1,"type":"string"},"postCount":{"type":"integer"},"type":{"minLength":1,"type":"string"},"url":{"format":"uri","type":"string"},"viewCount":{"type":"integer"}},"required":["id"],"type":"object"},"TikTokEntity":{"allOf":[{"$ref":"#/components/schemas/EntityCore"}],"unevaluatedProperties":false},"TikTokPlaylist":{"additionalProperties":false,"properties":{"cover":{"$ref":"#/components/schemas/MediaReference"},"createdAt":{"format":"date-time","type":"string"},"description":{"minLength":1,"type":"string"},"id":{"minLength":1,"type":"string"},"name":{"minLength":1,"type":"string"},"owner":{"$ref":"#/components/schemas/EntityReference"},"playCount":{"type":"integer"},"postCount":{"type":"integer"},"updatedAt":{"format":"date-time","type":"string"},"url":{"format":"uri","type":"string"}},"required":["id"],"type":"object"},"TikTokPost":{"allOf":[{"$ref":"#/components/schemas/PostCore"},{"properties":{"collaborators":{"anyOf":[{"items":{"$ref":"#/components/schemas/PostAuthor"},"type":"array"},{"type":"null"}]},"extended":{"$ref":"#/components/schemas/TikTokPostExtended"},"isAd":{"type":["boolean","null"]},"isPaidPartnership":{"type":["boolean","null"]},"location":{"anyOf":[{"$ref":"#/components/schemas/PostLocation"},{"type":"null"}]},"metrics":{"$ref":"#/components/schemas/TikTokPostMetrics"},"music":{"anyOf":[{"$ref":"#/components/schemas/PostMusic"},{"type":"null"}]},"sponsors":{"anyOf":[{"items":{"$ref":"#/components/schemas/PostAuthor"},"type":"array"},{"type":"null"}]},"taggedUsers":{"anyOf":[{"items":{"$ref":"#/components/schemas/PostAuthor"},"type":"array"},{"type":"null"}]}},"required":["metrics","taggedUsers","collaborators","sponsors","location","music","isAd","isPaidPartnership"],"type":"object"}],"unevaluatedProperties":false},"TikTokPostExtended":{"additionalProperties":false,"properties":{"aiLabelType":{"type":["integer","null"]},"allowsDuet":{"type":["boolean","null"]},"allowsStitch":{"type":["boolean","null"]},"isAiGenerated":{"type":["boolean","null"]},"isDownloadable":{"type":["boolean","null"]},"usesPromotionalMusic":{"type":["boolean","null"]}},"type":"object"},"TikTokPostMetrics":{"allOf":[{"$ref":"#/components/schemas/PostMetrics"},{"properties":{"downloads":{"type":["integer","null"]}},"required":["downloads"],"type":"object"}],"unevaluatedProperties":false},"TikTokProfile":{"allOf":[{"$ref":"#/components/schemas/ProfileCore"},{"properties":{"extended":{"$ref":"#/components/schemas/TikTokProfileExtended"}},"type":"object"}],"unevaluatedProperties":false},"TikTokProfileExtended":{"additionalProperties":false,"properties":{"hasCommerce":{"type":["boolean","null"]},"isProAccount":{"type":["boolean","null"]},"verificationLabel":{"type":["string","null"]},"verificationType":{"type":["integer","null"]}},"required":["verificationType","verificationLabel","isProAccount","hasCommerce"],"type":"object"},"TrendingCategory":{"additionalProperties":false,"properties":{"description":{"type":["string","null"]},"id":{"minLength":1,"type":"string"},"metrics":{"additionalProperties":false,"properties":{"posts":{"type":["integer","null"]},"views":{"type":["integer","null"]}},"required":["posts","views"],"type":"object"},"name":{"minLength":1,"type":"string"}},"required":["id","name","description","metrics"],"type":"object"},"TwitterComment":{"allOf":[{"$ref":"#/components/schemas/CommentCore"}],"unevaluatedProperties":false},"TwitterEntity":{"allOf":[{"$ref":"#/components/schemas/EntityCore"}],"unevaluatedProperties":false},"TwitterList":{"additionalProperties":false,"properties":{"createdAt":{"format":"date-time","type":["string","null"]},"description":{"type":["string","null"]},"id":{"minLength":1,"type":"string"},"isPrivate":{"type":["boolean","null"]},"metrics":{"additionalProperties":false,"properties":{"followers":{"type":["integer","null"]},"members":{"type":["integer","null"]}},"required":["members","followers"],"type":"object"},"name":{"minLength":1,"type":"string"},"owner":{"anyOf":[{"$ref":"#/components/schemas/PostAuthor"},{"type":"null"}]}},"required":["id","name","description","isPrivate","createdAt","owner","metrics"],"type":"object"},"TwitterPost":{"allOf":[{"$ref":"#/components/schemas/PostCore"},{"properties":{"extended":{"$ref":"#/components/schemas/TwitterPostExtended"},"metrics":{"$ref":"#/components/schemas/TwitterPostMetrics"},"quotedPost":{"anyOf":[{"$ref":"#/components/schemas/TwitterPost"},{"type":"null"}]},"repostedPost":{"anyOf":[{"$ref":"#/components/schemas/TwitterPost"},{"type":"null"}]}},"required":["metrics"],"type":"object"}],"unevaluatedProperties":false},"TwitterPostExtended":{"additionalProperties":false,"properties":{"conversationId":{"type":["string","null"]},"inReplyToPostId":{"type":["string","null"]},"inReplyToUserId":{"type":["string","null"]},"language":{"type":["string","null"]},"quotedPostId":{"type":["string","null"]},"repostedPostId":{"type":["string","null"]}},"type":"object"},"TwitterPostMetrics":{"allOf":[{"$ref":"#/components/schemas/PostMetrics"},{"properties":{"bookmarks":{"type":["integer","null"]},"quotes":{"type":["integer","null"]}},"required":["quotes","bookmarks"],"type":"object"}],"unevaluatedProperties":false},"TwitterProfile":{"allOf":[{"$ref":"#/components/schemas/ProfileCore"},{"properties":{"extended":{"$ref":"#/components/schemas/TwitterProfileExtended"}},"type":"object"}],"unevaluatedProperties":false},"TwitterProfileExtended":{"additionalProperties":false,"properties":{"banner":{"anyOf":[{"$ref":"#/components/schemas/MediaReference"},{"type":"null"}]},"createdAt":{"format":"date-time","type":["string","null"]},"likes":{"type":["integer","null"]},"location":{"type":["string","null"]},"media":{"type":["integer","null"]},"pinnedPostIds":{"items":{"minLength":1,"type":"string"},"type":"array"},"withheldCountries":{"items":{"minLength":1,"type":"string"},"type":"array"}},"required":["createdAt","location","banner","likes","media","pinnedPostIds","withheldCountries"],"type":"object"},"TwitterSuggestion":{"additionalProperties":false,"properties":{"highlighted":{"minLength":1,"type":"string"},"id":{"minLength":1,"type":"string"},"score":{"type":"number"},"text":{"minLength":1,"type":"string"},"type":{"minLength":1,"type":"string"},"user":{"$ref":"#/components/schemas/EntityReference"}},"required":["id","text"],"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 tools (legacy default).","read:instagram":"Read public Instagram data through MCP tools.","read:tiktok":"Read public TikTok data through MCP tools.","read:twitter":"Read public X (Twitter) 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.0.2"},"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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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:d4f0cfce89b6816492d87a52bcb65892d54aa54241241a268d34d1ae61100d1a","datasetVersion":"2026-09-07.1","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/Hashtag"}},"required":["data"],"type":"object"}]}}},"description":"A successful Test or Live response.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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:d4f0cfce89b6816492d87a52bcb65892d54aa54241241a268d34d1ae61100d1a","datasetVersion":"2026-09-07.1","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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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:d4f0cfce89b6816492d87a52bcb65892d54aa54241241a268d34d1ae61100d1a","datasetVersion":"2026-09-07.1","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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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:d4f0cfce89b6816492d87a52bcb65892d54aa54241241a268d34d1ae61100d1a","datasetVersion":"2026-09-07.1","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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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:d4f0cfce89b6816492d87a52bcb65892d54aa54241241a268d34d1ae61100d1a","datasetVersion":"2026-09-07.1","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/Location"}},"required":["data"],"type":"object"}]}}},"description":"A successful Test or Live response.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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:d4f0cfce89b6816492d87a52bcb65892d54aa54241241a268d34d1ae61100d1a","datasetVersion":"2026-09-07.1","example":{"identifier":"950000000002","query":"synthetic"}}}},"/v1/instagram/locations/{identifier}/guides":{"get":{"description":"List location guides 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_location_guides_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/InstagramLocationGuide"},"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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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 guides","tags":["Instagram","Entity"],"x-openhandle-operation":"instagram.location.guides.list","x-openhandle-sdk":{"operation":"list","paginated":true,"path":"instagram.location.guides.list","scope":[{"name":"instagram"},{"name":"location","parameter":"identifier","reference":"location"},{"name":"guides"}]},"x-openhandle-test-data":{"catalogUrl":"/v1/test-data?operation=instagram.location.guides.list","contentHash":"sha256:d4f0cfce89b6816492d87a52bcb65892d54aa54241241a268d34d1ae61100d1a","datasetVersion":"2026-09-07.1","example":{"comment":"synthetic comment","identifier":"910100000001","media_id":"910100000001","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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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:d4f0cfce89b6816492d87a52bcb65892d54aa54241241a268d34d1ae61100d1a","datasetVersion":"2026-09-07.1","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/Music"}},"required":["data"],"type":"object"}]}}},"description":"A successful Test or Live response.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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:d4f0cfce89b6816492d87a52bcb65892d54aa54241241a268d34d1ae61100d1a","datasetVersion":"2026-09-07.1","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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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:d4f0cfce89b6816492d87a52bcb65892d54aa54241241a268d34d1ae61100d1a","datasetVersion":"2026-09-07.1","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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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:d4f0cfce89b6816492d87a52bcb65892d54aa54241241a268d34d1ae61100d1a","datasetVersion":"2026-09-07.1","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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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:d4f0cfce89b6816492d87a52bcb65892d54aa54241241a268d34d1ae61100d1a","datasetVersion":"2026-09-07.1","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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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:d4f0cfce89b6816492d87a52bcb65892d54aa54241241a268d34d1ae61100d1a","datasetVersion":"2026-09-07.1","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":"Provider-specific public-data filter for this operation.","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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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:d4f0cfce89b6816492d87a52bcb65892d54aa54241241a268d34d1ae61100d1a","datasetVersion":"2026-09-07.1","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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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:d4f0cfce89b6816492d87a52bcb65892d54aa54241241a268d34d1ae61100d1a","datasetVersion":"2026-09-07.1","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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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:d4f0cfce89b6816492d87a52bcb65892d54aa54241241a268d34d1ae61100d1a","datasetVersion":"2026-09-07.1","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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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:d4f0cfce89b6816492d87a52bcb65892d54aa54241241a268d34d1ae61100d1a","datasetVersion":"2026-09-07.1","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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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:d4f0cfce89b6816492d87a52bcb65892d54aa54241241a268d34d1ae61100d1a","datasetVersion":"2026-09-07.1","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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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:d4f0cfce89b6816492d87a52bcb65892d54aa54241241a268d34d1ae61100d1a","datasetVersion":"2026-09-07.1","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/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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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:d4f0cfce89b6816492d87a52bcb65892d54aa54241241a268d34d1ae61100d1a","datasetVersion":"2026-09-07.1","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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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:d4f0cfce89b6816492d87a52bcb65892d54aa54241241a268d34d1ae61100d1a","datasetVersion":"2026-09-07.1","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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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:d4f0cfce89b6816492d87a52bcb65892d54aa54241241a268d34d1ae61100d1a","datasetVersion":"2026-09-07.1","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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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:d4f0cfce89b6816492d87a52bcb65892d54aa54241241a268d34d1ae61100d1a","datasetVersion":"2026-09-07.1","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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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:d4f0cfce89b6816492d87a52bcb65892d54aa54241241a268d34d1ae61100d1a","datasetVersion":"2026-09-07.1","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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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:d4f0cfce89b6816492d87a52bcb65892d54aa54241241a268d34d1ae61100d1a","datasetVersion":"2026-09-07.1","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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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:d4f0cfce89b6816492d87a52bcb65892d54aa54241241a268d34d1ae61100d1a","datasetVersion":"2026-09-07.1","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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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:d4f0cfce89b6816492d87a52bcb65892d54aa54241241a268d34d1ae61100d1a","datasetVersion":"2026-09-07.1","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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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:d4f0cfce89b6816492d87a52bcb65892d54aa54241241a268d34d1ae61100d1a","datasetVersion":"2026-09-07.1","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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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:d4f0cfce89b6816492d87a52bcb65892d54aa54241241a268d34d1ae61100d1a","datasetVersion":"2026-09-07.1","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 Instagram profile collection. 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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:d4f0cfce89b6816492d87a52bcb65892d54aa54241241a268d34d1ae61100d1a","datasetVersion":"2026-09-07.1","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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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:d4f0cfce89b6816492d87a52bcb65892d54aa54241241a268d34d1ae61100d1a","datasetVersion":"2026-09-07.1","example":{"identifier":"@northstar_forge_test"}}}},"/v1/instagram/profiles/{identifier}/reels":{"get":{"description":"Return a cursor-paginated Instagram profile collection. 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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:d4f0cfce89b6816492d87a52bcb65892d54aa54241241a268d34d1ae61100d1a","datasetVersion":"2026-09-07.1","example":{"identifier":"@northstar_forge_test"}}}},"/v1/instagram/profiles/{identifier}/related":{"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":"instagramProfileRelatedList","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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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 related","tags":["Instagram","Profile"],"x-openhandle-operation":"instagram.profile.related.list","x-openhandle-sdk":{"operation":"list","paginated":true,"path":"instagram.profile.related.list","scope":[{"name":"instagram"},{"name":"profile","parameter":"identifier","reference":"profile"},{"name":"related"}]},"x-openhandle-test-data":{"catalogUrl":"/v1/test-data?operation=instagram.profile.related.list","contentHash":"sha256:d4f0cfce89b6816492d87a52bcb65892d54aa54241241a268d34d1ae61100d1a","datasetVersion":"2026-09-07.1","example":{"identifier":"@northstar_forge_test"}}}},"/v1/instagram/profiles/{identifier}/reposts":{"get":{"description":"Return a cursor-paginated Instagram profile collection. 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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:d4f0cfce89b6816492d87a52bcb65892d54aa54241241a268d34d1ae61100d1a","datasetVersion":"2026-09-07.1","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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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:d4f0cfce89b6816492d87a52bcb65892d54aa54241241a268d34d1ae61100d1a","datasetVersion":"2026-09-07.1","example":{"comment":"synthetic comment","identifier":"@northstar_forge_test","media_id":"910100000001","query":"synthetic"}}}},"/v1/instagram/profiles/{identifier}/suggested":{"get":{"description":"Return the current 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"}}],"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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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":false,"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:d4f0cfce89b6816492d87a52bcb65892d54aa54241241a268d34d1ae61100d1a","datasetVersion":"2026-09-07.1","example":{"identifier":"@northstar_forge_test"}}}},"/v1/instagram/profiles/{identifier}/tagged-posts":{"get":{"description":"Return a cursor-paginated Instagram profile collection. 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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:d4f0cfce89b6816492d87a52bcb65892d54aa54241241a268d34d1ae61100d1a","datasetVersion":"2026-09-07.1","example":{"identifier":"@northstar_forge_test"}}}},"/v1/instagram/profiles/{identifier}/videos":{"get":{"description":"Return a cursor-paginated Instagram profile collection. 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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:d4f0cfce89b6816492d87a52bcb65892d54aa54241241a268d34d1ae61100d1a","datasetVersion":"2026-09-07.1","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/Hashtag"},"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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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:d4f0cfce89b6816492d87a52bcb65892d54aa54241241a268d34d1ae61100d1a","datasetVersion":"2026-09-07.1","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/Music"},"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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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:d4f0cfce89b6816492d87a52bcb65892d54aa54241241a268d34d1ae61100d1a","datasetVersion":"2026-09-07.1","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/Location"},"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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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:d4f0cfce89b6816492d87a52bcb65892d54aa54241241a268d34d1ae61100d1a","datasetVersion":"2026-09-07.1","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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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:d4f0cfce89b6816492d87a52bcb65892d54aa54241241a268d34d1ae61100d1a","datasetVersion":"2026-09-07.1","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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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:d4f0cfce89b6816492d87a52bcb65892d54aa54241241a268d34d1ae61100d1a","datasetVersion":"2026-09-07.1","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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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:d4f0cfce89b6816492d87a52bcb65892d54aa54241241a268d34d1ae61100d1a","datasetVersion":"2026-09-07.1","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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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:d4f0cfce89b6816492d87a52bcb65892d54aa54241241a268d34d1ae61100d1a","datasetVersion":"2026-09-07.1","example":{"comment":"synthetic comment","identifier":"910100000001","media_id":"910100000001","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"],"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"],"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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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:d4f0cfce89b6816492d87a52bcb65892d54aa54241241a268d34d1ae61100d1a","datasetVersion":"2026-09-07.1","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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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:d4f0cfce89b6816492d87a52bcb65892d54aa54241241a268d34d1ae61100d1a","datasetVersion":"2026-09-07.1","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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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:d4f0cfce89b6816492d87a52bcb65892d54aa54241241a268d34d1ae61100d1a","datasetVersion":"2026-09-07.1","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/Hashtag"}},"required":["data"],"type":"object"}]}}},"description":"A successful Test or Live response.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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:d4f0cfce89b6816492d87a52bcb65892d54aa54241241a268d34d1ae61100d1a","datasetVersion":"2026-09-07.1","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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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:d4f0cfce89b6816492d87a52bcb65892d54aa54241241a268d34d1ae61100d1a","datasetVersion":"2026-09-07.1","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/Location"}},"required":["data"],"type":"object"}]}}},"description":"A successful Test or Live response.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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:d4f0cfce89b6816492d87a52bcb65892d54aa54241241a268d34d1ae61100d1a","datasetVersion":"2026-09-07.1","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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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:d4f0cfce89b6816492d87a52bcb65892d54aa54241241a268d34d1ae61100d1a","datasetVersion":"2026-09-07.1","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/Music"}},"required":["data"],"type":"object"}]}}},"description":"A successful Test or Live response.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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:d4f0cfce89b6816492d87a52bcb65892d54aa54241241a268d34d1ae61100d1a","datasetVersion":"2026-09-07.1","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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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:d4f0cfce89b6816492d87a52bcb65892d54aa54241241a268d34d1ae61100d1a","datasetVersion":"2026-09-07.1","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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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:d4f0cfce89b6816492d87a52bcb65892d54aa54241241a268d34d1ae61100d1a","datasetVersion":"2026-09-07.1","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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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:d4f0cfce89b6816492d87a52bcb65892d54aa54241241a268d34d1ae61100d1a","datasetVersion":"2026-09-07.1","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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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:d4f0cfce89b6816492d87a52bcb65892d54aa54241241a268d34d1ae61100d1a","datasetVersion":"2026-09-07.1","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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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:d4f0cfce89b6816492d87a52bcb65892d54aa54241241a268d34d1ae61100d1a","datasetVersion":"2026-09-07.1","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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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:d4f0cfce89b6816492d87a52bcb65892d54aa54241241a268d34d1ae61100d1a","datasetVersion":"2026-09-07.1","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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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:d4f0cfce89b6816492d87a52bcb65892d54aa54241241a268d34d1ae61100d1a","datasetVersion":"2026-09-07.1","example":{"identifier":"@pixel_orchard_tt_test"}}}},"/v1/tiktok/profiles/{identifier}/liked-posts":{"get":{"description":"Return a cursor-paginated Tiktok profile collection. 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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:d4f0cfce89b6816492d87a52bcb65892d54aa54241241a268d34d1ae61100d1a","datasetVersion":"2026-09-07.1","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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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:d4f0cfce89b6816492d87a52bcb65892d54aa54241241a268d34d1ae61100d1a","datasetVersion":"2026-09-07.1","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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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:d4f0cfce89b6816492d87a52bcb65892d54aa54241241a268d34d1ae61100d1a","datasetVersion":"2026-09-07.1","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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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:d4f0cfce89b6816492d87a52bcb65892d54aa54241241a268d34d1ae61100d1a","datasetVersion":"2026-09-07.1","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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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:d4f0cfce89b6816492d87a52bcb65892d54aa54241241a268d34d1ae61100d1a","datasetVersion":"2026-09-07.1","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/Hashtag"},"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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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:d4f0cfce89b6816492d87a52bcb65892d54aa54241241a268d34d1ae61100d1a","datasetVersion":"2026-09-07.1","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/Location"},"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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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:d4f0cfce89b6816492d87a52bcb65892d54aa54241241a268d34d1ae61100d1a","datasetVersion":"2026-09-07.1","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/Music"},"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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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:d4f0cfce89b6816492d87a52bcb65892d54aa54241241a268d34d1ae61100d1a","datasetVersion":"2026-09-07.1","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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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:d4f0cfce89b6816492d87a52bcb65892d54aa54241241a268d34d1ae61100d1a","datasetVersion":"2026-09-07.1","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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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:d4f0cfce89b6816492d87a52bcb65892d54aa54241241a268d34d1ae61100d1a","datasetVersion":"2026-09-07.1","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/TrendingCategory"},"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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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:d4f0cfce89b6816492d87a52bcb65892d54aa54241241a268d34d1ae61100d1a","datasetVersion":"2026-09-07.1","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"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/SuccessEnvelope"},{"properties":{"data":{"$ref":"#/components/schemas/Music"}},"required":["data"],"type":"object"}]}}},"description":"A successful Test or Live response.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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":false,"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:d4f0cfce89b6816492d87a52bcb65892d54aa54241241a268d34d1ae61100d1a","datasetVersion":"2026-09-07.1","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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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:d4f0cfce89b6816492d87a52bcb65892d54aa54241241a268d34d1ae61100d1a","datasetVersion":"2026-09-07.1","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}":{"get":{"description":"Return one public Twitter list 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":"twitterListGet","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"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/SuccessEnvelope"},{"properties":{"data":{"$ref":"#/components/schemas/TwitterList"}},"required":["data"],"type":"object"}]}}},"description":"A successful Test or Live response.","headers":{"Openhandle-Billing-Disposition":{"description":"Accounting disposition.","schema":{"enum":["test","allowance","free","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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 Twitter list","tags":["Twitter","List"],"x-openhandle-operation":"twitter.list.get","x-openhandle-sdk":{"operation":"get","paginated":false,"path":"twitter.list.get","scope":[{"name":"twitter"},{"name":"list","parameter":"identifier","reference":"list"}]},"x-openhandle-test-data":{"catalogUrl":"/v1/test-data?operation=twitter.list.get","contentHash":"sha256:d4f0cfce89b6816492d87a52bcb65892d54aa54241241a268d34d1ae61100d1a","datasetVersion":"2026-09-07.1","example":{"identifier":"950000000005"}}}},"/v1/twitter/lists/{identifier}/members":{"get":{"description":"Return a cursor-paginated collection of Twitter list members. Test and Live use the same route, parameters, response schema, pagination, and errors. In Test, null means unavailable, not zero.","operationId":"twitterListMembersList","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/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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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 members","tags":["Twitter","Profile"],"x-openhandle-operation":"twitter.list.members.list","x-openhandle-sdk":{"operation":"list","paginated":true,"path":"twitter.list.members.list","scope":[{"name":"twitter"},{"name":"list","parameter":"identifier","reference":"list"},{"name":"members"}]},"x-openhandle-test-data":{"catalogUrl":"/v1/test-data?operation=twitter.list.members.list","contentHash":"sha256:d4f0cfce89b6816492d87a52bcb65892d54aa54241241a268d34d1ae61100d1a","datasetVersion":"2026-09-07.1","example":{"identifier":"950000000005"}}}},"/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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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:d4f0cfce89b6816492d87a52bcb65892d54aa54241241a268d34d1ae61100d1a","datasetVersion":"2026-09-07.1","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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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:d4f0cfce89b6816492d87a52bcb65892d54aa54241241a268d34d1ae61100d1a","datasetVersion":"2026-09-07.1","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/TwitterComment"},"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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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:d4f0cfce89b6816492d87a52bcb65892d54aa54241241a268d34d1ae61100d1a","datasetVersion":"2026-09-07.1","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/TwitterComment"},"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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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:d4f0cfce89b6816492d87a52bcb65892d54aa54241241a268d34d1ae61100d1a","datasetVersion":"2026-09-07.1","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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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:d4f0cfce89b6816492d87a52bcb65892d54aa54241241a268d34d1ae61100d1a","datasetVersion":"2026-09-07.1","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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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:d4f0cfce89b6816492d87a52bcb65892d54aa54241241a268d34d1ae61100d1a","datasetVersion":"2026-09-07.1","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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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:d4f0cfce89b6816492d87a52bcb65892d54aa54241241a268d34d1ae61100d1a","datasetVersion":"2026-09-07.1","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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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:d4f0cfce89b6816492d87a52bcb65892d54aa54241241a268d34d1ae61100d1a","datasetVersion":"2026-09-07.1","example":{"identifier":"@copperfield_lab_x_test"}}}},"/v1/twitter/profiles/{identifier}/media":{"get":{"description":"Return a cursor-paginated Twitter profile collection. 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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:d4f0cfce89b6816492d87a52bcb65892d54aa54241241a268d34d1ae61100d1a","datasetVersion":"2026-09-07.1","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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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:d4f0cfce89b6816492d87a52bcb65892d54aa54241241a268d34d1ae61100d1a","datasetVersion":"2026-09-07.1","example":{"identifier":"@copperfield_lab_x_test"}}}},"/v1/twitter/profiles/{identifier}/replies":{"get":{"description":"Return a cursor-paginated Twitter profile collection. 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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:d4f0cfce89b6816492d87a52bcb65892d54aa54241241a268d34d1ae61100d1a","datasetVersion":"2026-09-07.1","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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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:d4f0cfce89b6816492d87a52bcb65892d54aa54241241a268d34d1ae61100d1a","datasetVersion":"2026-09-07.1","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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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:d4f0cfce89b6816492d87a52bcb65892d54aa54241241a268d34d1ae61100d1a","datasetVersion":"2026-09-07.1","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/TwitterSuggestion"},"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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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:d4f0cfce89b6816492d87a52bcb65892d54aa54241241a268d34d1ae61100d1a","datasetVersion":"2026-09-07.1","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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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:d4f0cfce89b6816492d87a52bcb65892d54aa54241241a268d34d1ae61100d1a","datasetVersion":"2026-09-07.1","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. The underlying data read is metered once and redirects are never followed.","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":"entity"}},"required":["platform","resource","data"],"type":"object"}]},{"allOf":[{"$ref":"#/components/schemas/SuccessEnvelope"},{"properties":{"data":{"$ref":"#/components/schemas/InstagramHighlight"},"platform":{"const":"instagram"},"resource":{"const":"entity"}},"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"}]}]}}},"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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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","postpaid"],"type":"string"}},"Openhandle-Cost":{"description":"Authoritative actual customer charge. Always 0.000 for Test.","schema":{"type":"string"}},"Openhandle-Dataset-Version":{"description":"Synthetic dataset version. Present for Test.","schema":{"type":"string"}},"Openhandle-Environment":{"description":"Environment selected by the API key.","schema":{"enum":["test","live"],"type":"string"}},"Openhandle-List-Price":{"description":"Live-equivalent list price.","schema":{"type":"string"}},"RateLimit":{"description":"Remaining requests (r) and seconds until reset (t) for each evaluated policy. May be absent before authentication or when the limiter is unavailable.","example":"\"key\";r=9;t=1, \"organization\";r=49;t=1","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policies for the evaluated limits. Present after rate-limit evaluation. Uses draft-ietf-httpapi-ratelimit-headers-11.","example":"\"key\";q=10;w=1, \"organization\";q=50;w=1","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait 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":[]}}}},"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"],"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"}],"x-openhandle-test-data":{"catalogUrl":"/v1/test-data","contentHash":"sha256:d4f0cfce89b6816492d87a52bcb65892d54aa54241241a268d34d1ae61100d1a","datasetVersion":"2026-09-07.1"},"x-openhandle-versioning-policy":"https://openhandle.dev/docs/versioning"}